Skip to main content

Bulk Map Target Plus Listings

POST 

/api/target-plus/:integrationInstance/listings/bulk-map

Maps, re-maps or unmaps the chosen listings in one call.

Required scope: products:write

Grant 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​

OK

Response Headers
    Content-Type