​
Overview

The Bulk Product Upload endpoint allows sellers to import product data into Commenda using a CSV file. This is especially useful for onboarding existing catalogs or synchronizing product data across platforms.

​
Endpoint

POST /api/v1/products/bulk_upload/csv

​
Request Body

{
  "file_id": "string",          // Required: ID of the uploaded file
  "corporation_id": "string"    // Optional: Corporation to associate products with
}
  • The file_id should point to a previously uploaded CSV file via the /files endpoint.
  • If corporation_id is included, additional authorization checks are performed.

​
CSV File Requirements

  • Must be CSV format with headers.
  • Max file size: 15 MB
  • Content-Type must be one of the supported file types (e.g., text/csv)
  • Header row is required.

​
CSV Headers

Column HeaderRequiredTypeDescription
nameNostringName of the product
descriptionNostringShort description of the product
skuNostringUnique identifier used by seller
product_taxability_codeNostringTax code indicating how the product is taxed. Defaults to TPP.
source_platformNoenumIntegration source (SHOPIFY, STRIPE, etc)
source_platform_idNostringUnique product ID from the source platform
corporation_idYesstringUUID of the corporation owning the product

​
Sample CSV

name,description,sku,product_taxability_code,source_platform,source_platform_id,corporation_id
Sunglasses,UV-protected PT-1035,PT-1035,TPP,SHOPIFY,prod_abc123,acme-corp-uuid

​
Notes

  • Commenda creates an async import job to process the CSV.
  • You can monitor job status via the Jobs API.
  • Only the first few rows are validated synchronously. Deeper row-level validation is handled asynchronously in the import job.
  • The import is non-blocking—you’ll receive a job ID to track progress.