Map Ad Item to Product
POST/api/advertising/unmapped-items/:adItem/map
Maps an advertised item to a SKU.io product. The manual mapping takes precedence over automatic matching on every later sync, and the item's past spend and sales are restated onto the product in the background.
advertising:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Requires the advertising.manage permission. Token scope: advertising:write (personal access and OAuth tokens).
Body: product_id (integer, required): the product this advertised item sells. Must exist.
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
Response Headers
Not Found
Response Headers
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.