Register a device for push notifications
POST/notifications/devices
Registers the calling user's device so notifications can also reach it as a native push. Idempotent on the token: repeating the call refreshes the registration, and a token last registered by another user is moved to the caller, which is what a shared or resold handset needs. Clients are expected to call this on launch and whenever the provider rotates the token.
Request
Responses
- 200
- 400
- 401
- 403
- 429
The device is registered
The token is missing or too long, or the platform is not one of ios, android, web
Unauthorized
Forbidden - request denied by authorization, or blocked by the API firewall
Too many requests - rate limited by the API firewall; wait out the Retry-After delay before retrying
Response Headers
Retry-After
Delay in seconds a client must wait before retrying the request