Skip to main content

Upload Data Import

POST 
/api/v2/data-imports

Uploads mapped CSV data for import and kicks off background validation. Returns the data import ID and a tracked job log ID to poll for validation progress.

Authentication: Requires Bearer token.

Request Body:

  • entity_type (required, string): Type of entity being imported (e.g. products)
  • file_name (required, string, max:255): Original filename for display
  • column_mapping (required, array): Maps column positions to field names
  • mapped_rows (required, array, min:1): Array of row objects with mapped field values
  • metadata (nullable, array): Optional metadata

Request​

Responses​

Successful response