Upload Target Plus Listing Mappings
POST/api/target-plus/:integrationInstance/listings/mappings-csv
Uploads a mapping sheet (the Download Target Plus Listing Mappings CSV) and maps each listing to the SKU.io product it names. Each row names a listing by seller_sku and the product by map_to_sku; a blank map_to_sku unmaps the listing. Other columns are ignored.
products:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Send dry_run=1 to check the file without changing anything: the response then says what would change. Rows that cannot be applied are listed in invalid_rows with their CSV row number (the header is row 1) and the reason (empty seller SKU, unknown seller SKU, variation parent, unknown SKU.io product); the other rows are still applied.
Body: multipart/form-data with file (required, CSV, max 10 MB) and dry_run (optional boolean, default false).
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.