Skip to main content
POST
Send a single-device push test

Endpoints

  • POST /push/test-notifications
  • GET /push/test-notifications/:id
An ad hoc test requires a public app ID, one device ID, a title, and a body:
To test a saved draft, replace title/body with campaign_id. The API clones the draft into a test-only delivery and still targets only the selected device. Poll the returned test ID until a notification record appears. Inspect its provider and client events before treating the integration as successful. Provider acceptance alone does not prove that the OS displayed a notification.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
app_id
string
required

Public push app ID or app resource ID.

device_id
string
required

One device ID returned by the push device list.

campaign_id
string<uuid>

Optional saved push campaign draft to test.

title
string
Maximum string length: 120
body
string
Maximum string length: 240
image_url
string<uri>
launch_url
string
Maximum string length: 2048
channel_id
string
Maximum string length: 80

Response

Push test queued

status
number
data
unknown
error
unknown
metadata
unknown