Create new coupon

POST

https://numueg.app/api/v1/stores/{store_id}/coupons/

Last modified:2026-09-19 16:39:33

x-numu-scope:marketing:write

Create a new coupon for the store.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//coupons/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "code": "SUMMER25",
    "coupon_type": "percentage",
    "max_discount_amount": "50.00",
    "min_order_amount": "100.00",
    "usage_limit": 100,
    "valid_from": "2025-06-01T00:00:00Z",
    "valid_until": "2025-08-31T23:59:59Z",
    "value": "25.00"
}'

Response Example

201 - Example 1

{
    "success": true,
    "data": {
        "code": "SUMMER25",
        "coupon_type": "percentage",
        "created_at": "2025-05-15T10:00:00Z",
        "id": "880e8400-e29b-41d4-a716-446655440000",
        "is_active": true,
        "is_expired": false,
        "is_usable": true,
        "max_discount_amount": "50.00",
        "min_order_amount": "100.00",
        "store_id": "660e8400-e29b-41d4-a716-446655440000",
        "updated_at": "2025-05-15T10:00:00Z",
        "usage_count": 12,
        "usage_limit": 100,
        "valid_from": "2025-06-01T00:00:00Z",
        "valid_until": "2025-08-31T23:59:59Z",
        "value": "25.00"
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

Adopt a linked conversation's profile picture as the customer photo

List coupons