Skip to main content


The Token Management API is used to store and track user device tokens. User device tokens are commonly used to send push notifications.

This API allows you to /send messages to a :user_id and Courier will automatically route the messages to the correct device tokens.

Multiple tokens with mulitiple providers can be managed in Courier for a user, allowing you to send a message to multiple devices with a single /send call.

Token status is automatically tracked and invalid or expired tokens are handled for you.

Token Management APIs are all endpoints prefixed with /users/:user_id/tokens

Push Notification Providers:

Courier Mobile SDKs:

If are you using a Courier Mobile SDK:

  • iOS will automatically manage APNS tokens
  • Android will automatically manage FCM tokens

If you need to support FCM on iOS, see the mobile docs for your SDK for more details: