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

# Push Notifications

> Send mobile push notifications by adding PUSH to your channels array to reach users instantly on their mobile devices

<Warning>
  Please note that you can only send push notifications, once you've completed the registration process for your app as mentioned in the [Push Notifications Prerequisites](/alerts/integrate-inbox/api/push-notifications#prerequisites) section.
</Warning>

## How to Send Push

Simply include `PUSH` in your channels array:

<Tabs>
  <Tab title="curl">
    ```bash theme={null}
    curl https://alerts-api.dial.to/v2/{appId}/send \
      --request POST \
      --header 'x-dialect-api-key: YOUR_API_KEY' \
      --header 'Content-Type: application/json' \
      --data '{
        "recipient": {
          "type": "subscriber",
          "walletAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
        },
        "channels": ["PUSH", "IN_APP"],
        "message": {
          "title": "Trade Executed! 📈",
          "body": "Your buy order for 10 SOL has been executed at $142.50"
        }
      }'
    ```
  </Tab>

  <Tab title="TypeScript">
    ```typescript theme={null}
    const notification = {
      recipient: {
        type: 'subscriber',
        walletAddress: '9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM'
      },
      channels: ['PUSH', 'IN_APP'],
      message: {
        title: 'Trade Executed! 📈',
        body: 'Your buy order for 10 SOL has been executed at $142.50'
      }
    };

    await fetch(`https://alerts-api.dial.to/v2/${appId}/send`, {
      method: 'POST',
      headers: {
        'x-dialect-api-key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify(notification)
    });
    ```
  </Tab>
</Tabs>

## Adding Custom Data

Include custom data for your app to handle deep linking or specific actions:

```typescript theme={null}
const pushWithData = {
  recipient: {
    type: 'subscriber',
    walletAddress: 'USER_WALLET_ADDRESS'
  },
  channels: ['PUSH'],
  message: {
    title: 'Price Alert! 🚨',
    body: 'SOL reached your target price of $150'
  },
  data: {
    action: 'price_alert',
    symbol: 'SOL',
    price: '150.00',
    alertId: 'alert_123'
  }
};
```

## Push Channel Ownership

**If you own the push channel** (have your own Firebase/FCM setup):

* You can send push notifications directly using `PUSH` in channels
* Consider mirroring `IN_APP` channel to see interesting push notifications from other projects that you might want to push to your users

**If you're a project without push channel ownership**:

* You cannot directly use the `PUSH` channel
* This is because push notifications require Firebase Cloud Messaging (FCM) integration and device token management
* Users need to have your specific mobile app installed and configured to receive your push notifications

## Complete Push Implementation

For full push notification setup including Firebase configuration, mobile app integration, user subscription management, and message handling, see:

**[Push Notifications in Inbox Integration →](/alerts/integrate-inbox/api/push-notifications)**