latestOpenAPI 3.1.02026-08-1014497184.0 KB

8b99dca11019

mobile_push
apns

Save an APNs token

Saves the APNs token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel.

put/channels/mobile_push/apns/tokens

Request body

app_idstring

The bundle identifier of the application registering this token. Use this to override the default identifier configured on the APNs integration.

device_tokenstring required

The APNs device token to register with MagicBell.

installation_id'development' | 'production'

The APNs environment this token belongs to. If omitted we assume it targets production.

Example request

{
  "device_token": "eH0fLhuiRj2Np7UQ-opXAm:APA91bGtC-wH4sgW1jWkMKIZf7FYkm_RTQb7Jid7DfSJnCgivGYoRzhLrGxpcIF6yPjmbzAr6CKF-6phZkBasFUUfZmfdgcqfA_ZlZdVk6pSnon3LGzMumCzEJE0zgWoo_RUmVUVJUAt",
  "installation_id": "development"
}

Response

OK

app_idstring

The bundle identifier of the application registering this token. Use this to override the default identifier configured on the APNs integration.

device_tokenstring required

The APNs device token to register with MagicBell.

installation_id'development' | 'production'

The APNs environment this token belongs to. If omitted we assume it targets production.

Example response

{
  "device_token": "eH0fLhuiRj2Np7UQ-opXAm:APA91bGtC-wH4sgW1jWkMKIZf7FYkm_RTQb7Jid7DfSJnCgivGYoRzhLrGxpcIF6yPjmbzAr6CKF-6phZkBasFUUfZmfdgcqfA_ZlZdVk6pSnon3LGzMumCzEJE0zgWoo_RUmVUVJUAt",
  "installation_id": "development"
}