Channels

• Different teams should receive different notifications (for example, marketing, developers, devops, sre).

• You can assign users, devices, or both to a channel.
• You can choose channels per request using target.channels.
• You can keep some API key broad and scope other API key to specific channels.

​

How Targeting Works

{
  "target": {
    "channels": ["ios-beta", "ops"]
  }
}

• If target is omitted and API key scope is all, delivery goes to all recipients in the account.
• If target is omitted and API key scope is channels, delivery goes to channels assigned to that API key.
• If target.channels is provided, only those channel slugs are targeted.

​

Push Notifications

{
  "title": "New subscription 💸",
  "message": "Customer upgraded to Pro plan",
  "target": {
    "channels": ["ios-beta", "ops"]
  }
}

​

Live Activities

{
  "content_state": {
    "title": "Nightly database backup",
    "number_of_steps": 3,
    "current_step": 1,
    "type": "segmented_progress"
  },
  "target": {
    "channels": ["ios-beta", "ops"]
  }
}

• /api-reference/endpoint/push-notification
• /api-reference/endpoint/live-activity-start