Upload and inspect an import file
POST/api/v1/accounts/:account_id/data_imports/analyze
First of the three import steps. Uploads the spreadsheet, reads it, and answers with everything the wizard needs to build a mapping: the headers, a few sample rows, the row count, a guess at which column means what, the fields available to map onto, and any saved mapping whose columns match this file.
The file is stored once and named by blob_id; preview and create reuse that
id instead of uploading again.
A file the reader cannot parse — malformed CSV, a broken workbook — answers 422 rather than 500.
Request
Responses
- 200
- 403
- 422
Success
Not an administrator
No file was sent, or it could not be parsed