Skip to main content
POST
Create Product Listing
Publishes a product to your app’s sales channel. Create the sales channel first — the listing is attached to the channel resolved from your app identity. Publishing is idempotent: listing a product that is already listed returns the existing listing (200), reactivated if it was inactive and with external_id updated when you send one. The body can be flat or wrapped in { "product_listing": { ... } }. Auth: OAuth access token with the write_products scope.

Body Parameters

string | integer
required
The product to publish: its UUID (product_id) or its numeric id.
string
The product’s id on the external channel, if you’re mirroring it. Stored and returned as-is.

Request

Response

A bare product_listing object — 201 when created, 200 when the product was already listed.

Errors

Errors are a standard { "errors": { "base": [...] } } body.