Carillon docs
Devices

Import devices from a CSV

Store a CSV for asynchronous processing. Tokens are not validated with APNs or FCM during import. Existing tokens in this app are skipped without updating their data.

POST
/v1/devices/import

Store a CSV for asynchronous processing. Tokens are not validated with APNs or FCM during import. Existing tokens in this app are skipped without updating their data.

AuthorizationBearer <token>

An API key, sent as Authorization: Bearer carillon_sk_live_…. A secret key sends, reads traces and manages devices; a mobile key may only register its own device and report that device’s events.

In: header

Request Body

text/csv

TypeScript Definitions

Use the request body type in TypeScript.

body*string

CSV with a header and one device per row. Required: token, platform (ios or android). Optional: environment (iOS only; production or sandbox, defaults to production), external_id, timezone_id (IANA identifier), locale. Unknown columns are ignored and listed in the report.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/devices/import" \  -H "Content-Type: text/csv" \  -d 'string'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "status": "pending",  "counts": {    "created": 0,    "already_present": 0,    "invalid": 0  },  "errors": [    {      "line": 0,      "field": "string",      "message": "string"    }  ],  "errors_truncated": true,  "ignored_columns": [    "string"  ],  "failure": "string",  "created_at": "2019-08-24T14:15:22Z",  "finished_at": "2019-08-24T14:15:22Z"}