Request Payload

Required Fields

Field	Type	Description
`title`	`string`	The notification title (required, must not be empty)

Optional Fields

Field	Type	Description
`subtitle`	`string`	The notification body/message text
`data`	`object`	Custom key-value pairs to send with the notification. All values must be strings.
`token`	`string`	FCM device token for sending to a single device
`tokens`	`string[]`	Array of FCM device tokens for sending to multiple devices
`topic`	`string`	FCM topic name for sending to all subscribers of that topic (defaults to `all` if not specified)

Targeting Options

You can specify one of the following targeting options:

Single Device: use token
Multiple Devices: use tokens (sends in parallel)
Topic: use topic (or omit to use default all topic)

If multiple targeting options are provided, the priority order is token > tokens > topic.

Custom Redirect URL

You can include a custom redirect URL in data.url to specify where the app should navigate when the notification is tapped.

{
  "title": "Check this out!",
  "subtitle": "Click to view more details",
  "data": {
    "url": "https://example.com/details"
  },
  "token": "fGhI1jKlMnOpQrStUvWxYz..."
}

03 May 2026