Register a mobile device for push notifications

posthttps://api.expiryedge.com/v1/registerDeviceToken
any role60/min
Request
curl -X POST 'https://api.expiryedge.com/v1/registerDeviceToken' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "fcm_token": "dQw4w9WgXcQ:APA91bH-example-token",
  "platform": "ios",
  "device_id": "6F1C2B9A-8D3E-4F7A-9B21-0C5D7E8F9A10",
  "app_version": "2.4.1"
}'
Response
{
  "success": true
}

Upserts one registration per (user, device_id), so re-registering on app relaunch does not create duplicates.

Body parameters

application/json
  • fcm_tokenstringrequired
    Firebase Cloud Messaging registration token.
  • platformstringrequired
    Allowediosandroid
  • device_idstringrequired
    Stable per-install device identifier.
  • app_versionstring

Returns

200
Device registered.
  • successboolean
  • messagestring

Errors

400
The request is missing required fields or contains invalid values.
401
Missing, expired or invalid bearer token.
404
The record does not exist or is not in your organization.
405
The endpoint does not accept this HTTP method.
429
Too many requests for this endpoint from your IP. Wait Retry-After seconds.
500
Unexpected server error. Retry later; quote requestId to support.