# Send a push notification campaign

## How to create and send a push notification campaign

In this guide, we'll show you how to set up and send your first push notifications marketing campaign.

### What you'll need

* [Install](https://docs.bird.com/api/client-sdks/applications) a push notifications channel within an application configuration.
* Push Notifications message template.
* [list](/applications/~/changes/SidqSnOUVNHmcp2wkLG7/audience-and-contacts/lists-and-segments/concepts/lists.md) or [segment](/applications/~/changes/SidqSnOUVNHmcp2wkLG7/audience-and-contacts/lists-and-segments/concepts/segments.md) of contacts that have valid device tokens registered for Push Notifications.&#x20;

### Create your Push Notifications campaign

1. From the main side menu, click **Campaigns**.
2. Click **Create campaign**. If no push notification channel is installed yet, click **Set up Push Notification** - it redirects you to the [Application settings](https://docs.bird.com/api/client-sdks/applications) to create a new application connected with Push Notifications.<br>

   <figure><img src="/files/k65GghmSGme7zGU1Ldjb" alt=""><figcaption></figcaption></figure>
3. Once Push Notification channel is installed select **Push notification** and click **Save and continue**.\
   \[Optional] You could define a campaign name and select a schedule date or tags here, but it also possible to set these within the campaign setup wizard

<figure><img src="/files/ZkLPqxuN7CPUreSltylr" alt=""><figcaption></figcaption></figure>

### Setup Push Notifications campaign wizard

### Step one: Choose your recipients

<figure><img src="/files/cGW6XwVqvyAvpkput9ua" alt=""><figcaption></figcaption></figure>

1. From the **Send to** drop-down, select the [list](/applications/~/changes/SidqSnOUVNHmcp2wkLG7/audience-and-contacts/lists-and-segments/concepts/lists.md) or [segment](/applications/~/changes/SidqSnOUVNHmcp2wkLG7/audience-and-contacts/lists-and-segments/concepts/segments.md) you want to send your campaign to. \ <br>

   <figure><img src="/files/WCYey47ng3IKnasyms0N" alt=""><figcaption></figcaption></figure>

   You can select more than one list or segment. <br>

   <figure><img src="/files/NqFoyI4GxjN1UUAPRxO1" alt=""><figcaption></figcaption></figure>
2. \[Optional] If you want to prevent this campaign from being sent to specific customers, use the **Don't send to** dropdown to select the lists or segments that you want to exclude.<br>

   <figure><img src="/files/hJioEMqq3CtRaIefvQQn" alt=""><figcaption></figcaption></figure>
3. \[Optional] you could define a **maximum number of recipients** to send the campaign you could set the limit<br>

   <figure><img src="/files/zm3UuKEZWcyATRFcqpcl" alt=""><figcaption></figcaption></figure>
4. Click **Continue to content** to continue.

### Step two: Choose your Push Notification content

<figure><img src="/files/2ZQhvP3geHnE961HyU5V" alt=""><figcaption></figcaption></figure>

1. Use the **Send from** dropdown to choose the push notification channel that you want to send your campaign from.<br>

   <figure><img src="/files/irTRy0CBbjzJsPuY7rFU" alt=""><figcaption></figcaption></figure>
2. Use the **Select a template** dropdown to choose the [Push Notifications message template](/applications/~/changes/SidqSnOUVNHmcp2wkLG7/content/message-templates/how-to/create-push-notifications-message-templates.md) that you want to send as your campaign. You'll be able to see a preview of your message.<br>

   <figure><img src="/files/QMFrRlxCHwjtjBGN8Iun" alt=""><figcaption></figcaption></figure>
3. \[Optional] If your message template is localized into more than one language, choose the language that you want to send it in.
4. If there are variables in your template message, map them in the **Template variables** section.<br>

   <figure><img src="/files/cnxr8mPsKMWmxsQDVt7t" alt=""><figcaption></figcaption></figure>
5. Click **Continue to preview** to continue.

### Step three: Preview and test your campaign

<figure><img src="/files/k5gSEI8sEBaGSZKw2r04" alt=""><figcaption></figcaption></figure>

1. We are almost ready to push the campaign.
2. Check recipients number for the campaign.
3. Review the message you're sending as a push notification.<br>

   <figure><img src="/files/LTMoLTMlHOzIMmF63bZ9" alt=""><figcaption></figcaption></figure>
4. \[Optional] you may send a test message:
   * Select a contact in the **Simulated contact** dropdown that you want to send a test message and click **Send a test message.**\
     ![](/files/ViS8gPLA49tEPUIAKRTk)
5. If the campaign is ready to go click **Schedule or send**.

### Launch the campaign: Send or schedule your campaign

There are two options or sending the campaign:

1. Select **Schedule** to [send your campaign at a future date and time](/applications/~/changes/SidqSnOUVNHmcp2wkLG7/campaigns/campaigns/how-to/schedule-a-campaign.md) and click **Schedule**.<br>

   <figure><img src="/files/G7HuNv8dx2nEcFl6frkz" alt=""><figcaption></figcaption></figure>
2. Send your campaign now, select the **Send now** optio&#x6E;**,** then click **Send**.<br>

   <figure><img src="/files/mU388UnEWBbBo1dw7pCN" alt=""><figcaption></figcaption></figure>


---

# 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.bird.com/applications/~/changes/SidqSnOUVNHmcp2wkLG7/campaigns/push-notifications/how-to/send-a-push-notification-campaign.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.
