> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Send app push notifications

> Check your SDK integration and set up app push notifications in Notifly.

1. Make sure the [Notifly SDK](https://docs.notifly.tech/en/developer-guide/index.md) is installed in your app.
2. Run the [app push integration test](https://docs.notifly.tech/en/integration-test.md#3-test-app-push-notifications).

## 1. Set when to send

App push supports scheduled, event-triggered, and API-triggered sends. See [Campaign send timing](https://docs.notifly.tech/en/user-guide/campaigns/basic.md#2-delivery-timing) for details.

For users with the app on multiple devices, where the notification goes depends on how the send is triggered.

* For scheduled and API-triggered sends, Notifly sends to all of the user's devices.
* For event-triggered sends, Notifly sends only to the device where the user triggered the event.

## 2. Set the audience

To select recipients for app push, set up a user group or upload a CSV. See [Set up a user group](https://docs.notifly.tech/en/user-guide/campaigns/campaign-segments/segment.md#1-user-group-settings).

## 3. Set the message content and action

### 3-1. Basic notification settings

Set the title, body, image, and what happens when a user taps the notification.

![Basic settings for an app push campaign](https://mintcdn.com/notifly/dcFO7QF5JScPffiH/images/i18n/en/app-push-notification/app-push-campaign-basic-settings.png?fit=max\&auto=format\&n=dcFO7QF5JScPffiH\&q=85\&s=4a7e07a32ba67dfe8f5498c097be83d4)

#### 3-1-1. Set the title and body

Enter the title and body to preview the notification.

* The amount of text shown varies by device. To reduce truncation, keep Android titles within 65 characters and bodies within 240. On iOS, keep the notification within roughly four lines (178 characters in total).
* You can include emoji.

#### 3-1-2. Add an image (optional)

* Use a PNG or JPEG (.jpg or .jpeg) file.
* We recommend a 2:1 aspect ratio (width to height).
* Keep the image within 1024 px in both width and height and 150 KB in file size.

![Image settings for an app push notification](https://mintcdn.com/notifly/dcFO7QF5JScPffiH/images/i18n/en/app-push-notification/app-push-campaign-image.png?fit=max\&auto=format\&n=dcFO7QF5JScPffiH\&q=85\&s=05a47a05094d07cb1200a90cb75961e6)

#### 3-1-3. Set the tap action (optional)

* By default, tapping a notification opens the app.
* To open a web page when the user taps the notification, enter the page URL. To open a specific screen in the app, enter a deep link that your app already handles.

> [!WARNING]
>
> For app deep links, use an app-specific URL scheme such as `appName://`.

### 3-2. Advanced notification settings (optional)

![Advanced settings for an app push campaign](https://mintcdn.com/notifly/dcFO7QF5JScPffiH/images/i18n/en/app-push-notification/app-push-campaign-advanced-settings.png?fit=max\&auto=format\&n=dcFO7QF5JScPffiH\&q=85\&s=95c5b859cc66862fb2e121f905947805)

#### 3-2-1. Set the notification importance (Android only)

On Android, the importance level controls how prominently the notification appears and whether it makes a sound. For a heads-up notification, select **High**.

#### 3-2-2. Disable the notification badge (Android only)

A badge is an indicator on the app icon. Turn on **Disable Notification Badge** to hide it on Android.

#### 3-2-3. Add custom message data

Add custom data to the push message's `data` field. For example, your app can use it to add messages to its notification inbox or handle different types of push notifications.

## 4. Send promotional app push notifications

Record each user's marketing consent through the app SDK. Set up an opt-out page and send only to users who opted in. For a single-language message, turn on **Is Advertising Message**. For a localized message, add the required advertising disclosures and opt-out instructions to each language version. To reuse the consent filter across campaigns, add it as a default user condition.

See [Set up opt-outs for promotional app push notifications](https://docs.notifly.tech/en/user-guide/channel/app-push-notification/marketing-push-compliance.md).

## 5. Receive delivery results through a webhook

Use a webhook to receive app push delivery results from Notifly in real time. Open **Settings > Channel Settings > Push Notification (App)** and enter your endpoint in **Webhook URL for Receiving Delivery Results**.

![Webhook URL field for app push delivery results](https://mintcdn.com/notifly/dcFO7QF5JScPffiH/images/i18n/en/app-push-notification/notification-webhook-url.png?fit=max\&auto=format\&n=dcFO7QF5JScPffiH\&q=85\&s=aff9d3b03f24c6ad046cbe907e633e1f)

When the webhook is enabled, Notifly sends a `POST` request each time it sends an app push notification successfully. The campaign and user journey examples below show `"ios"` in the `platform` field. For Android, the value is `"android"`.

**\[Campaign]**

```json theme={null}
{
  "userId": "user-example",
  "resourceType": "campaign",
  "campaignId": "campaign-example",
  "platform": "ios",
  "token": "example-fcm-token",
  "title": "Notification title",
  "body": "Notification body",
  "url": "appName://inbox",
  "sent_time": 1772787674021
}
```

**\[User journey]**

```json theme={null}
{
  "userId": "user-example",
  "resourceType": "user_journey",
  "userJourneyId": "journey-example",
  "userJourneyNodeId": "node-example",
  "sessionId": "session-example",
  "platform": "ios",
  "token": "example-fcm-token",
  "title": "Notification title",
  "body": "Notification body",
  "url": "appName://inbox",
  "sent_time": 1772787674021
}
```

When you set a webhook URL for the project, Notifly enables the webhook by default for new app push campaigns and for new app push message nodes you add in the journey builder. To turn it off for a campaign, disable **Receive push delivery results via webhook** in the campaign settings. To turn it off for a journey node, disable **Receive Push Delivery Results via Webhook** in the node settings.

![Campaign setting for receiving push delivery results via webhook](https://mintcdn.com/notifly/dcFO7QF5JScPffiH/images/i18n/en/app-push-notification/enable-notification-webhook.png?fit=max\&auto=format\&n=dcFO7QF5JScPffiH\&q=85\&s=d099a5195365ae46bc96fe2876652972)

You can use these results to build a notification inbox in your app. Notifly sends the results through the [Webhook channel](https://docs.notifly.tech/en/user-guide/channel/webhook/guide.md). Check your project's rate for this channel before enabling the webhook.

## FAQ

> [accordion] What should I check if I didn't receive a push notification?
>
> Run the [app push integration test](https://docs.notifly.tech/en/integration-test.md#3-test-app-push-notifications).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.