Assign master products

Assigns master product codes to outlet SKUs, synchronising the mapping between each outlet's local product identifier and the global product code used across your organisation.

If an existing assignment doesn't exist for the outlet_ext_id + outlet_product_code combination, it is created. If an assignment already exists for that combination, it is overwritten with the supplied master_product_code.

If the master product has not been ingested via /ingest/v1/products first, a placeholder master product is created automatically. These placeholder master products can be enriched later by ingesting the full product record via /ingest/v1/products.

Removing an assignment

To remove an existing assignment, ingest an entry with the same outlet_ext_id and outlet_product_code, and either omit master_product_code, set it to null, or send a blank/whitespace-only string. Any matching assignment for the (outlet_ext_id, outlet_product_code) pair is removed; if none exists, the entry is a no-op.

Impact on segmentation

Segment membership may be determined by the products that customers have purchased. Therefore, changes
to master product assignments may impact which segments a customer belongs to. Within 24 hours, customer
transactions affected by updated product code mappings will be reprocessed, and any segments that
customers are now eligible for (or no longer eligible for) will be updated accordingly.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

An array of products to assign master products to

Responses
200

Successful operation

400

Validation Error

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here!