Skip to main content

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​

Success