Add Import

POST 
/import/add

Initiates a new import job and returns a pre-signed URL to upload the file. Use CSV for most entities, or KML/KMZ for Area. Upload Area files with Content-Type: application/octet-stream; upload CSV files with Content-Type: text/csv. After upload, processing begins automatically. CSV files support at most 500 columns, including unmapped columns. Account imports reject files with more than 5,000 rows missing latitude or longitude, regardless of disableGeocoding. Records are split into batches and processed through a shared queue with controlled parallelism. Splitting files does not increase worker capacity, and completion times can vary with workload. Requires the import permission for the entity (for example account:import, user:import, or area:add for Area). Track progress with /import/get or /import/list. See Importing Data for sizing guidance and processing behavior.

Request

Responses

200

Success

default

Error

4XX

Unauthorized