Import Customers using CSV

This API method that you can use to import or update customer data. To get a proper and valid response, please send a CSV file with data separated by commas.

curl -X POST \ \
  -F [email protected]/path/to/customers.csv \
  -H "X-App-Id: c70a6f00-cf91-4756-9df5-47628850002b" \
  -H "X-App-Token: 3266b9f8-e246-4f79-bdf0-833929b1380c"

The CSV file has to include headers in the first line. All properties which cannot be mapped to standard customer fields will be added to the metadata object.


Standard customer fields mapping

"Source_id", "Name", "Description", "Email", "Address_City", "Address_Country", "Address_Postal_Code", "Address_State", "Address line 1", "Address line 2", "Phone", "Birthday".

In the case you want to update customer's data, you can do it using the CSV file with new data. However, remember to include a customer_id or source_id in your CSV file to manage the update successfully.

Please note that while updating customers using CSV import, when you provide both customer id and source_id in the CSV file, the source_id field will be ignored.


Returns 202 HTTP status code on success. It informs that your request has been accepted and vouchers will be added to the repository asynchronously. To learn about operation status and result, copy the async action id from the API response and use Get Async Action endpoint.

Returns 400 HTTP error status code when the CSV file includes incorrect data e.g. with a wrong data type for the metadata properties.

Click Try It! to start a request and see the response here!