Add ASINs in Bulk (CSV)

When you need to seed a collection with hundreds or thousands of products, the CSV bulk upload is the fastest path. Prepare a spreadsheet, export it as CSV, and let the importer validate and insert every row in one shot.

In the dashboard

1. Open the bulk drawer

Inside any Amazon collection, click the Bulk Add button in the top-right toolbar. The bulk import drawer slides in from the right.

2. Download the CSV template

Click Download template to get a pre-formatted CSV with the correct column headers. Open it in Excel, Google Sheets, or any spreadsheet editor.

The template contains exactly four columns (no others are recognised):

Fill in one ASIN per row. The domain must match a domain you have configured, and the postcode must match a postcode you have already created for that domain. Save the file as CSV when done.

3. Drop or select your file

Drag your CSV onto the dropzone, or click inside it to open a file picker.

4. Confirm the file selection

Once a file is selected, a file chip appears showing the filename. Review it, then click Import to begin the upload.

5. Review the results

After the import finishes, a results summary shows the success count and error count for the upload.

If any rows could not be imported (unrecognised domain, missing postcode, duplicate ASIN, etc.), an error table lists each failed row alongside its reason.

Fix the flagged rows in your spreadsheet and re-upload just those rows. Rows that succeeded are already in the collection and will not be duplicated.

Via the API

Bulk upload (CSV file)

This endpoint accepts a multipart/form-data request containing the collection ID and the CSV file.

The CSV file must have a header row. Required columns are domain (domain name string, e.g. amazon.com.au), customer_postcode (postcode value, e.g. 4500), asin (Amazon ASIN), and include_raw_html (true or false). Extra columns are ignored. Domain and postcode are matched by string value — the backend resolves them to IDs internally. Rows with an unrecognised domain or postcode are added to error_rows without aborting the rest of the import.

Example CSV content:

domain,customer_postcode,asin,include_raw_html
amazon.com.au,4500,B0DJQQ38TG,true
amazon.com.au,4500,B0ABC12345,false
amazon.com,10001,B0XYZ99999,true

curl https://multicartapi.com/api/v1/schedules/amazon/asin/create/bulk/ \
  -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -F "collection_id=101" \
  -F "csv=@/path/to/asins.csv"

{
"code": 200,
"data": {
  "success_count": 2,
  "error_rows": []
},
"status": 1
}

When some rows fail, the response still returns code: 200 — check error_rows to identify which ASINs were skipped:

{
"code": 200,
"data": {
  "success_count": 2,
  "error_rows": [
    { "asin": "B0XYZ99999", "error": "Duplicate entry" }
  ]
},
"status": 1
}

Alternative: comma-separated ASINs (no file upload)

If you have a small list of ASINs that all share the same domain and postcode, you can use POST /schedules/amazon/asin/create/multiple/ instead. Pass the ASINs as a comma-separated string — no file required.

curl https://multicartapi.com/api/v1/schedules/amazon/asin/create/multiple/ \
  -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "collection": 101,
    "domain": "amazon.com.au",
    "customer_postcode": "4500",
    "asins": "B0DJQQ38TG,B0ABC12345,B0XYZ99999",
    "including_raw_html": false
  }'

{
"code": 200,
"data": {
  "success_count": 2,
  "error_rows": [
    { "asin": "B0XYZ99999", "error": "Duplicate entry" }
  ]
},
"status": 1
}