Create a coupon (admin)

POST

https://uat-api.hastaai.in/api/v1/admin/coupons

admin

Last modified:2026-08-13 18:45:26

Request: application/json

Creates a coupon. The eligibility filters (registered_before, first_purchase_only, applicable_slugs) are composable, so a single coupon can combine them. sticky_for_renewal + razorpay_offer_id apply to recurring plans only - razorpay_offer_id must be created in the Razorpay Dashboard first (Razorpay Offers cannot be created via API) and pasted in here.

Body: code, discount_type, discount_value, valid_from, valid_till, plus optional eligibility/scope fields

Success: 200 - coupon created

Errors: 403 - not an admin | 409 - code already exists

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

Example

{
    "applicable_slugs": [
        "sage-monthly",
        "sage-quarterly",
        "sage-half-yearly",
        "sage-yearly",
        "guru-monthly",
        "guru-quarterly",
        "guru-half-yearly",
        "guru-yearly"
    ],
    "campaign_tag": "first_purchase_plan",
    "code": "FIRSTPLAN20",
    "description": "20% off your first Sage or Guru \n    subscription (capped at Rs 200), locked in for renewals",
    "discount_type": "percent",
    "discount_value": 20,
    "first_purchase_only": true,
    "is_active": true,
    "max_discount_amount": 200,
    "max_redemptions_per_user": 1,
    "sticky_for_renewal": true,
    "valid_from": 1752739200000,
    "valid_till": 1760688000000
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://uat-api.hastaai.in/api/v1/admin/coupons' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "applicable_slugs": [
        "sage-monthly",
        "sage-quarterly",
        "sage-half-yearly",
        "sage-yearly",
        "guru-monthly",
        "guru-quarterly",
        "guru-half-yearly",
        "guru-yearly"
    ],
    "campaign_tag": "first_purchase_plan",
    "code": "FIRSTPLAN20",
    "description": "20% off your first Sage or Guru \n    subscription (capped at Rs 200), locked in for renewals",
    "discount_type": "percent",
    "discount_value": 20,
    "first_purchase_only": true,
    "is_active": true,
    "max_discount_amount": 200,
    "max_redemptions_per_user": 1,
    "sticky_for_renewal": true,
    "valid_from": 1752739200000,
    "valid_till": 1760688000000
}'

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Coupon created successfully"
}

🟠403Forbidden

🟠406

🟠409

🟠422Parameter Error

🟠429

Modified at 2026-08-13 18:45:26

Sync a recurring plan with Razorpay

List coupons (admin)