Skip to main content
POST
Bulk Upload SKU Commissions

Overview

Create or update SKU-level commission rates and cost of goods values in bulk. Each SKU is upserted — if a matching SKU already exists for your shop it is updated, otherwise a new record is created.

Use Cases

  • Bulk-set commission overrides for hundreds of SKUs at once
  • Sync cost of goods from an ERP or inventory system
  • Onboard new product lines with pre-configured commission rates
  • Periodic updates to COGS values as supplier pricing changes

Request Body

array
required
Array of SKU commission records (max 500 per request).

Response

Success — all items processed:
200
Partial failure — some items had validation errors:
200
Validation error — request-level:
422
This endpoint uses upsert behavior. If a SKU already exists for your shop, the provided fields are updated. If it doesn’t exist, a new SKU record is created. Duplicate SKUs within the same request are processed in order — the last entry wins.
Commission values are applied as-is. A commissionRate of 14 means 14% (not 0.14). Do not divide by 100.

Example