Import

Bulk import data from CSV/spreadsheet files into the system.

📄️ Add Import

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. See [Importing Data](/docs/info/import#file-limits-and-sizing) for sizing guidance and processing behavior.

📄️ Get Import

Retrieve the status and details of a single import by its ID.

📄️ List Imports

Retrieve a page of imports for the current company, newest first. Pass the previous response cursor to fetch the next page. Archived imports are excluded unless archived is set.

📄️ Get Import Errors

Retrieve the error records for an import. Each record contains a pre-signed URL to download the raw error data for that row.

📄️ Cleanup Import

Rolls back and removes all records that were created by the specified import. Use this to undo an import that contained incorrect data.