<- Loyalty API

Loyalty API

Create loyalty promotion

POST

 /v2/loyalty/programs/{program_id}/promotions

A loyalty promotion enables buyers to earn points in addition to those earned from the base loyalty program.

This endpoint sets the loyalty promotion to the ACTIVE or SCHEDULED status, depending on the available_time setting. A loyalty program can have a maximum of 10 loyalty promotions with an ACTIVE or SCHEDULED status.

Permissions:LOYALTY_WRITE
Try in API Explorer
Link to section

Path parameters

Example code

Link to section

program_id

string

Required

Link to section

Request body

Link to section

loyalty_promotion

Required

The loyalty promotion to create.

Link to section

idempotency_key

string

Required

A unique identifier for this request, which is used to ensure idempotency. For more information, see Idempotency.

Link to section

Response fields

Link to section

errors

Any errors that occurred during the request.

Link to section

loyalty_promotion

The new loyalty promotion.