Skip to main content
Channels let you target specific groups of recipients instead of sending to everyone in an account. Common use case:
  • Different teams should receive different notifications (for example, marketing, developers, devops, sre).
Channels are flexible:
  • 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

Use channel slugs in target.channels: 
{
  "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"]
  }
}
See endpoint docs for full request and response fields: