Skip to main content
POST
Preview Promotion Prices

Authorizations

Authorization
string
header
required

Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.

Path Parameters

promotionId
string<uuid>
required

Body

application/json
productIds
string<uuid>[]
required
Required array length: 1 - 50 elements
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
organizationId
string

Required for session auth. Optional for an API key, which already identifies the organization.

Required string length: 1 - 120
marketplace
enum<string>
Available options:
lazada,
shopee,
tiktok,
shopify,
amazon,
zalora,
ebay
country
string
Required string length: 1 - 80
storeId
string
Required string length: 1 - 120
variantSku
string | null
Required string length: 1 - 120

Response

Canonical operation result. Inspect aggregate and per-target success and marketplace delivery evidence.

previews
object[]
required