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.
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.
Authorization
ApiKey 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.
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"}