Skip to main content

Add multiple tokens to user

Adds multiple tokens to a user and overwrites matching existing tokens.

URL: https://api.courier.com/users/:user_id/tokens

Method: PUT

PATH PARAMS

user_idstringrequired
The user's ID. This can be any uniquely identifiable string.
RESPONSES:

status: 204 OK

status: 400 Bad Request

messagestring
A message describing the error that occurred.
typestring
[invalid_request_error] The type of error that occurred.
Request Example
curl --request PUT \
--url https://api.courier.com/users/user-1234/tokens \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '
[
{
"token": "ABW7HO9Y7XAQXZ7Y",
"provider_key": "firebase-fcm",
"device": {
"app_id": "com.example.app",
"ad_id": "1234567890",
"device_id": "1234567890",
"platform": "android",
"manufacturer": "Samsung",
"model": "SM-G930F"
},
"tracking": {
"os_version": "9",
"ip": "1.2.3.4",
"lat": "1.2",
"long": "3.4"
},
"expiry_date": "2030-01-01T00:00:00.000Z"
}
]
'
Responses Example
Empty
{
"message": "Error Message",
"type": "invalid_request_error"
}

Examples‚Äč

  • URL: /users/user-1234/tokens
  • Method: PUT
  • Body:
{
"tokens": [
{
"token": "ads23fghsdfgsd32",
"provider_key": "apn",
"properties": {
"is_person": true
},
"device": {
"app_id": "com.my.app",
"platform": "iOS",
"model": "iPhone 13"
}
},
{
"token": "b2345dfgdgnwa",
"provider_key": "apn",
"tracking": {
"ip": "127.0.0.1",
"lat": "0.0",
"long": "123"
}
},
{
"token": "c32432fsdfdsdsfscxzcz",
"provider_key": "firebase-fcm",
"device": {
"device_id": "ipad",
"platform": "ipadOS",
"model": "iPad mini"
}
}
]
}
Was this helpful?