# Creating a Notification

Use Notifications to send a push notification to devices with your app installed. You can target all registered devices or filter to a specific segment.

Before sending a notification, your app must be registered with UbiQuity. See Apps for details.

***

### Creating a notification

When you create a notification you are taken to the Notification Dashboard. From here you can step through the notification wizard:

1. **Content and Preview**
2. **Filter**
3. **Schedule and Confirm**

UbiQuity saves your progress at each step, so you can come back and continue working on a notification at any time. You can also click **Confirm** to jump directly to the confirmation step.

***

### Content and Preview

Content and Preview is where you build the notification content. You can write the message, apply iOS and Android settings, and add custom data.

For details on the content fields available, see Notification Templates. The same fields apply when building a one-off notification.

***

### Filter

The filter screen lists all devices registered for the selected app. If devices were linked to database contacts when registered, you will also see the associated contact data.

You can filter by:

* Registered device fields
* Database contact fields
* Results from previous notifications
* Interactions with other UbiQuity channels such as mailouts and TXT messages
* Survey or event responses (if sent via UbiQuity Mail or TXT)

A contact may have multiple devices registered. Filtering for a contact will return all devices associated with that contact.

#### AND and OR conditions

**AND** — all conditions must be true for a contact to be included. *Example: Country = New Zealand AND Segment = Customer includes only contacts who are customers in New Zealand.*

**OR** — either condition can be true for a contact to be included. *Example: Country = New Zealand OR Segment = Customer includes all contacts in New Zealand plus all customers, regardless of country.*

***

### Schedule and Confirm

You can choose to prepare the notification now or at the time of sending.

| Option               | Behaviour                                                                                                                     |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Prepare now          | Filters and contact data are applied immediately. Changes to your database after this point will not affect the notification. |
| Prepare at send time | Filters and contact data are applied at the scheduled send time, reflecting your database as it is then.                      |

If you are sending a notification that invites recipients to contact a call centre, consider scheduling at an hourly rate to help manage incoming traffic volume.

***

### Pausing and cancelling

Once a notification has been scheduled, you can pause or cancel it from the Notification Dashboard, provided not all messages have already been delivered.

The notification report shows how many messages were delivered.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ubiquity.co.nz/documentation/channels/push/creating-a-notification.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.