Bulk Map Target Plus Listings
POST/api/target-plus/:integrationInstance/listings/bulk-map
Maps, re-maps or unmaps the chosen listings in one call.
products:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
action:
map_by_sku: each unmapped listing is linked to the SKU.io product whose SKU equals its seller SKU, else to the one product carrying its UPC. Listings that are already mapped are skipped.remap: mapped listings are matched the same way and re-pointed when the match is a different product. Unmapped listings are skipped.unmap: the mapping is removed from mapped listings.
Variation parents have no SKU of their own and are always skipped. The response counts listings mapped, unmapped, skipped (not eligible for the action, or already on the matching product) and no_match (no SKU.io product with the same SKU or UPC).
Body: action (required: map_by_sku, remap or unmap), mode (optional, selected (default) or all), ids (array of listing IDs, required unless mode is all, max 5000), filters (optional object, used when mode is all: the same filter keys List Target Plus Listings accepts, without the filter[...] wrapper, e.g. {"mapping": "unmapped"}). IDs that belong to another integration are ignored. Archived listings are excluded from mode: all unless filters includes an archived filter.
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.