Create promotion code

Create a new promotion code linked to an existing promotion

POST /api/public/v1/promotion-codes/create

cURL

basic

curl --request POST \
  --url https://app.tagadapay.com/api/public/v1/promotion-codes/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "SUMMER20",
  "promotionId": "promo_123",
  "usageLimit": 100,
  "expiresAt": "2025-08-31T23:59:59.000Z",
  "firstTimeCustomersOnly": false,
  "description": "Summer sale 20% off code"
}
'

200

{
  "id": "pc_123",
  "code": "SUMMER20",
  "promotionId": "promo_123",
  "storeId": "store_123",
  "active": true,
  "usageCount": 0,
  "usageLimit": 100,
  "firstTimeCustomersOnly": false,
  "expiresAt": "2025-08-31T23:59:59.000Z"
}

Authorizations

Authorization · string · header · required

Enter your API key as: Bearer your-api-key

Body

application/json

code · string · required

Minimum string length: 1

promotionId · string · required

customerId · string

usageLimit · integer

Required range: x > 0

expiresAt · string

firstTimeCustomersOnly · boolean · default: false

emailPattern · string

description · string

metadata · string

Response

200

application/json

Successful response