Coupon API

Give every new signup their own single-use coupon, emailed in seconds. Then check and redeem it at checkout or at the counter. Each code works exactly once, however many systems call in.

Get your API key

Included in the Growth plan. See pricing

Ready-made setups

A coupon for every new signup, without writing the code yourself.

Lovable, Bolt, Replit or another AI site builder

Paste this into the builder's chat. Replace PASTE_CAMPAIGN_ID with your campaign's ID, and give it your API key when it asks for the secret.

When a new user signs up, give them a welcome coupon from ReviewQR.

- Do it in a backend function (edge function or server function), never in the browser. Store my ReviewQR API key as a secret named REVIEWQR_API_KEY.
- After the signup succeeds, send: POST https://reviewqr.app/api/v1/coupons/issue
  Headers: Authorization: Bearer <REVIEWQR_API_KEY>, Content-Type: application/json
  Body: {"campaignId": "PASTE_CAMPAIGN_ID", "email": <the new user's email>, "name": <their name, if we have it>}
- ReviewQR emails the coupon to the user. A 200 response means done ("result" is "issued" or "already_issued").
- If the call fails, log the error and let the signup finish anyway. Never show the coupon code in the page.
- API reference: https://reviewqr.app/coupon-api

Zapier, Make, n8n, Zoho Flow

Trigger: new signup, new form entry, new CRM contact or new Shopify customer. Action: an HTTP / Webhooks request with these settings.

Method:  POST
URL:     https://reviewqr.app/api/v1/coupons/issue
Headers: Authorization: Bearer rqk_live_...
         Content-Type: application/json
Body:    {"campaignId": "PASTE_CAMPAIGN_ID", "email": "{{email}}", "name": "{{first_name}}"}

Want to send it on WhatsApp or SMS from your own tool instead? Add "sendEmail": false and use coupon.url from the response in your message.

Reference

Four endpoints, JSON in and out. Send your key as a bearer token on every request. Limit: 300 requests per minute per key. Call them from a server, never from a browser, so the key stays secret.

Authentication

Authorization: Bearer rqk_live_...

Keys only work on campaigns and coupons of your own account. A key from a different account gets 404, never someone else's data. Create keys in Dashboard, Coupon API.

1. List your campaigns

Find the id of the campaign to give coupons from. It is also shown on each campaign's page.

curl "https://reviewqr.app/api/v1/campaigns" \
  -H "Authorization: Bearer rqk_live_..."

200 response

{
  "campaigns": [
    {
      "id": "3f2c…",
      "name": "Welcome discount",
      "discountText": "10% off your first order",
      "businessName": "Acme Tees",
      "expiresAt": null,
      "expired": false,
      "archived": false,
      "total": 100,
      "free": 87,        // coupons nobody has yet
      "redeemed": 4,
      "createdAt": "2026-11-17T09:00:00.000Z"
    }
  ]
}

2. Issue a coupon to one person

For a new signup, a new contact in your CRM or a step in Zapier, Make or n8n. Gives the person the next free coupon of the campaign and emails it to them in the campaign's language, from your own domain when you set one up.

curl -X POST "https://reviewqr.app/api/v1/coupons/issue" \
  -H "Authorization: Bearer rqk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"campaignId":"3f2c…","email":"ana@example.com","name":"Ana"}'

Body fields

campaignIdrequiredFrom List your campaigns.
emailemail or phoneWho gets the coupon. One coupon per email per campaign.
phoneoptionalWith the country code, like +919876543210. Used to tell people apart only when there is no email.
nameoptionalShown in the email greeting.
sendEmaildefault truefalse = no email, you send the link yourself (WhatsApp, SMS, your own email tool).
resenddefault falsetrue = email it again when the person already had one.

200 response

{
  "result": "issued",          // issued | already_issued
  "emailed": true,
  "status": "valid",           // valid | redeemed | expired
  "coupon": {
    "code": "ABCD-1234",
    "url": "https://reviewqr.app/c/ABCD-1234?from=link",
    "imageUrl": "https://reviewqr.app/api/coupons/sticker/ABCD-1234",
    "recipient": { "email": "ana@example.com", "name": "Ana", "phone": null },
    "redeemedAt": null,
    "createdAt": "2026-11-17T09:00:00.000Z"
  },
  "campaign": { "id": "3f2c…", "name": "Welcome discount", … }
}

Outcomes

200issuedNew coupon for this person (emailed unless sendEmail is false).
200already_issuedThey had one already: same coupon back, no second email unless resend is true. Webhook retries are safe.
409out_of_couponsCampaign and account are out of coupons. When only the campaign is out, a new coupon is made from your plan or pack.
410campaign_expiredIssue from a campaign that has not ended.
502email_failedThe email did not go out, so nobody got the coupon. Safe to retry.
404campaign_not_foundCheck campaignId.

Send one request per person and retry only after a response: two calls for the same email at the very same moment can give out two coupons.

3. Validate (read-only)

Check a code before you apply the discount. Never changes the coupon.

curl "https://reviewqr.app/api/v1/coupons/validate?code=ABCD-1234" \
  -H "Authorization: Bearer rqk_live_..."

200 response

{
  "status": "valid",            // valid | redeemed | expired
  "coupon": {
    "code": "ABCD-1234",
    "redeemedAt": null,
    "createdAt": "2026-09-04T10:12:00.000Z"
  },
  "campaign": {
    "id": "…",
    "name": "Q4 launch",
    "discountText": "First transfer fee free",
    "businessName": "Acme Remit",
    "expiresAt": "2026-12-31T00:00:00.000Z"
  }
}

4. Redeem (marks the coupon used)

Call this at the moment you apply the discount. Atomic: if two systems redeem the same code at once, exactly one gets 200.

curl -X POST "https://reviewqr.app/api/v1/coupons/redeem" \
  -H "Authorization: Bearer rqk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"code":"ABCD-1234"}'

Outcomes

200redeemedDone. Apply the discount.
409already_redeemedUsed before (or by a concurrent call). Do not apply.
410expiredCampaign expiry passed.
404not_foundUnknown code.

Safe to retry on network errors: a repeated redeem is a 409, never a second redemption.

Errors

401missing_api_key / invalid_api_keyCheck the header and that the key is not revoked.
403plan_requiredAccount no longer on a plan with API access.
400missing_code / missing_campaign_id / missing_recipient / invalid_email / invalid_phoneThe message says which field to fix.
429rate_limitedBack off for Retry-After seconds.

Coupons issued and redeemed through the API show up in the campaign dashboard like any other, with the person's name and email.