Skip to main content
POST
Create Product Subscription

Authorizations

x-api-key
string
header
required

Body

application/json

What to subscribe to: a canonical product's offer events, optionally narrowed by merchant domains and a variant selection.

product_id
string
required

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

events
enum<string>[]
required

Offer event types to receive.

Minimum array length: 1
Available options:
offer.price.changed,
offer.availability.changed,
offer.created,
offer.deleted
domains
string[] | null

Restrict events to offers on these merchant domains (e.g. nike.com, max 25). Omitted = every offer.

selection
SelectedOption · object[] | null

Pin the subscription to one variant configuration: one {name, label} per configurable dimension, in the shape of variants.selected on the product detail response.

Minimum array length: 1

Response

Successful Response

A product subscription's scope and lifecycle state.

subscription_id
string
required
product_id
string
required
events
enum<string>[]
required
Available options:
offer.price.changed,
offer.availability.changed,
offer.created,
offer.deleted
locale
WebhookLocale · object
required

The locale the subscription reads the product in.

status
enum<string>
required

Lifecycle status: "active" or "cancelled"

Available options:
active,
cancelled
created_at
string<date-time>
required
domains
string[] | null
selection
StoredSelection · object[] | null