コンテンツにスキップ

Send a push notification to all active subscribers

POST
/api/v1/apps/{appId}/notify

Enqueues a broadcast for every active subscriber of the app. Session tokens and full-scope API keys are accepted. Individual endpoint targeting is not supported.

appId
required
string
object
title
required

Notification title

string
body
required

Notification body

string
url

HTTPS URL to open on click

string format: uri
/^[Hh][Tt][Tt][Pp][Ss]:///
icon
string format: uri
/^[Hh][Tt][Tt][Pp][Ss]:///
badge
string format: uri
/^[Hh][Tt][Tt][Pp][Ss]:///

Notification broadcast enqueued

object
ok
required
boolean
send_id
required
string

Missing required fields or invalid URL

Unauthorized

Full-scope API key required

App not found (NOT_FOUND)

Payload too large (PAYLOAD_TOO_LARGE)

Monthly limit exceeded or rate limited (RATE_LIMITED)