A .csv file that you must upload with your list of device identifiers.
The CSV file must contain a header for device identification: either deviceId or externalId.
Only one of these headers should be present.
If you want to create campaigns with variable params for each device, the header must contain the name of every param as columns.
Example device list (using deviceId):
deviceId
be5d3f02-f486-47e2-bd98-5128e1c4b065
be5d78f2-f486-47e2-bd98-5128e1c4b066
be5d3f02-a345-47e2-bd98-1234wqe34241
...
Example device list (using externalId):
externalId
code123
code456
...
Restrictions and limitations:
-
Empty rows (blank lines) are silently skipped and will not be imported.
-
Quoted multi-line CSV fields are NOT supported. RFC 4180 (section 2.6) allows
a field value to span multiple lines if it is enclosed in double quotes. This
endpoint does NOT support that feature. If the CSV contains such fields, the
embedded newline will be misinterpreted as a row separator, corrupting the data
or causing the request to fail with a generic error.
Unsupported example:
deviceId,description
abc123,"This description
spans two lines"
