Skip to main content
POST
Create Promotion

Authorizations

Authorization
string
header
required

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

Body

application/json
name
string
required
Maximum string length: 200
discountType
enum<string>
required
Available options:
percentage,
fixed_amount
discountValue
number
required

Positive discount amount or percentage (must be > 0).

Required range: x >= 0
storeKeys
string[]
required

Connected store keys as marketplace:country:storeId.

Minimum array length: 1
organizationId
string

Required for session auth across multiple organizations. Optional for OAuth/API keys bound to one organization.

Maximum string length: 120
description
string | null
Maximum string length: 2000
startsAt
string<date-time> | null
endsAt
string<date-time> | null
minSalePrice
number | null
Required range: x >= 0
maxDiscountAmount
number | null
Required range: x >= 0
minSpend
number | null

Lazada voucher minimum spend. Defaults to 1 when unset.

Required range: x >= 0

Response

Promotion created.

promotion
object
required