Build your own websiteAPI referenceAnnouncements
Register a push token against an allow-listed topic
Header Parameters
X-Site*string
The site key identifying which website this request belongs to. May be omitted only when the request comes from a domain already verified for the site (the Origin/Host then resolves it), or when the deprecated X-Subdomain header is used.
X-Api-Key?string
Publishable (pk_…) or secret (sk_…) key for this site. Required on writes; accepted on reads. NOTE: currently rolling out in monitor mode — a write without a valid key is logged rather than refused, so this is documented as optional. It becomes required on writes when enforcement is switched on; send it now.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
curl -X POST "https://example.com/api/public/notifications/subscribe" \ -H "X-Site: string" \ -H "Content-Type: application/json" \ -d '{}'Empty