Create coupon

POST

/store/coupons

Requires store:coupons plus the corresponding current financial permission of the token creator. Discount API fields use camelCase. Feature must be enabled. Versions enforce optimistic concurrency. No hard deletion; archive campaigns instead.

Requisição

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200OK

application/json

Success

Bodyapplication/json

🟠401Não Autorizado

🟠403Proibido

🟠422Erro de Parâmetro

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location '/store/coupons' \
--header 'Content-Type: application/json' \
--data '{
    "code": "string",
    "name": "string",
    "status": "draft",
    "version": 1,
    "rules": {
        "kind": "percent",
        "value": 1,
        "maxDiscountCents": 1,
        "minimumCents": 0,
        "productUuids": [
            "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
        "categoryUuids": [
            "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ]
    },
    "startsAt": "2019-08-24T14:15:22.123Z",
    "endsAt": "2019-08-24T14:15:22.123Z",
    "usageLimit": 1,
    "perContactLimit": 1,
    "contactUuid": "130ccdf7-4f0b-4926-8172-e9dea0604f4d",
    "allowAi": true
}'

Response Example

200 - Exemplo 1

{
    "code": "string",
    "name": "string",
    "status": "draft",
    "version": 1,
    "rules": {
        "kind": "percent",
        "value": 1,
        "maxDiscountCents": 1,
        "minimumCents": 0,
        "productUuids": [
            "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
        "categoryUuids": [
            "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ]
    },
    "startsAt": "2019-08-24T14:15:22.123Z",
    "endsAt": "2019-08-24T14:15:22.123Z",
    "usageLimit": 1,
    "perContactLimit": 1,
    "allowAi": true,
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "currency": "string",
    "personal": true
}

Modificado em 2026-10-22 18:13:52

Página anterior

List coupons

Próxima página

Replace coupon using current version