Create or update products in bulk
POST/v2/products/bulk/:lookupKey
Processes up to two thousand products in a single request, creating new products and updating existing ones.
Matching is driven by the lookup method declared on the URL: each item is matched against existing products using its internal identifier, stock keeping unit, supplier code or external source identifier. Items that do not match an existing product are created.
Directives may be supplied to fine-tune update behaviour, for example to merge new localized variants with existing ones, skip fields that are already populated, or reset specific lists. Per-item outcomes are returned in the response so callers can detect partial successes and retry only the items that failed.
Request
Responses
- 200
- 400
- 401
- 403
- 500
The bulk request completed; per-item outcomes are reported in the response payload.
The request payload, path, or query parameters failed validation.
Authentication credentials are missing or invalid.
The authenticated caller is not permitted to perform the operation.
An unexpected error prevented the request from completing.