Skip to main content
PATCH

Authorizations

x-publisher-token
string
header
required

Publisher token, as displayed in the Publisher Dashboard.

Path Parameters

couponName
string
required

Coupon name.

Example:

"summer26"

Body

application/json
active
boolean

Whether the coupon is active.

Example:

false

maxRedemptionsPerCustomer
integer | null

Maximum number of times a customer can redeem this coupon. Set to null to remove the maximum redemptions per customer.

Example:

5

expiredBy
string<date-time> | null

Expiration date of the coupon. Set to null to remove the expiration date and make the coupon permanent.

Example:

"2026-12-31T23:59:59.000Z"

startsAt
string<date-time>

Start date of the coupon validity. If not provided, defaults to current date and time.

Example:

"2026-06-16T09:30:53.378Z"

supportedOfferExternalIds
string[]

List of offer external IDs that support this coupon. Empty array means all offers are supported.

Note: This represents both the offer.sku value in the Create Checkout Session API, and the publisherOfferId in the Offers V2 API.

Example:
firstTimePurchase
boolean

Whether the coupon is only valid for first-time purchases.

Example:

false

allowedPlayers
string[]

List of player IDs allowed to use this coupon. Empty array means all players are allowed.

Example:

Response

Coupon updated successfully.

name
string

Coupon name.

Example:

"summer26"

active
boolean

Whether the coupon is active.

Example:

true

discountPercentage
number

Discount percentage applied by the coupon.

Example:

1

maxRedemptionsPerCustomer
integer

Maximum number of times a customer can redeem this coupon.

Example:

2

expiredBy
string<date-time>

Expiration date of the coupon.

Example:

"2025-04-02T06:54:51.670Z"

startsAt
string<date-time>

Start date of the coupon validity.

Example:

"2025-02-02T06:54:51.670Z"

supportedOfferExternalIds
string[]

List of offer external IDs that support this coupon. Empty array means all offers are supported.

Example:
firstTimePurchase
boolean

Whether the coupon is only valid for first-time purchases.

Example:

false

allowedPlayers
string[]

List of player IDs allowed to use this coupon. Empty array means all players are allowed.

Example: