Create Coupon Endpoint

POST

/admin/coupons

Create a new coupon (Admin only)

User-specific: assigned to one user, one-time use

Global: available to all users, one-time per user

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Successful Response

Body

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/admin/coupons' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": "string",
    "value_usd": 1,
    "coupon_scope": "user_specific",
    "max_uses": 1,
    "valid_until": "2019-08-24T14:15:22Z",
    "coupon_type": "promotional",
    "assigned_to_user_id": 0,
    "description": "string",
    "valid_from": "2019-08-24T14:15:22Z"
}'

Response Example

200 - Example 1

{
    "id": 0,
    "code": "string",
    "value_usd": 0,
    "coupon_scope": "string",
    "coupon_type": "string",
    "max_uses": 0,
    "times_used": 0,
    "valid_from": "2019-08-24T14:15:22Z",
    "valid_until": "2019-08-24T14:15:22Z",
    "is_active": true,
    "created_at": "2019-08-24T14:15:22Z",
    "assigned_to_user_id": 0,
    "created_by": 0,
    "created_by_type": "string",
    "description": "string"
}

Modified at 2025-10-27 16:08:17

Get Rate Limit Alerts Endpoint

List Coupons Endpoint