Create Product Subscription
Subscribe to a canonical product’s offer events; an identical active subscription returns the existing one.
Authorizations
Body
What to subscribe to: a canonical product's offer events, optionally narrowed by merchant domains and a variant selection.
Canonical product ID, as returned by /v1/products or /v1/lookup. Lookup IDs are canonicalized automatically; if the lookup is still processing, creation fails with 409 — retry with the same ID
Offer event types to receive.
1offer.price.changed, offer.availability.changed, offer.created, offer.deleted Restrict events to offers on these merchant domains (e.g. nike.com, max 25). Omitted = every offer.
Pin the subscription to one variant configuration: one {name, label} per configurable dimension, in the shape of variants.selected on the product detail response.
1Response
Successful Response
A product subscription's scope and lifecycle state.
offer.price.changed, offer.availability.changed, offer.created, offer.deleted The locale the subscription reads the product in.
Lifecycle status: "active" or "cancelled"
active, cancelled