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.
Included in the Growth plan. See pricing
A coupon for every new signup, without writing the code yourself.
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-apiTrigger: 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.
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.
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.
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"
}
]
}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
| campaignId | required | From List your campaigns. |
| email or phone | Who gets the coupon. One coupon per email per campaign. | |
| phone | optional | With the country code, like +919876543210. Used to tell people apart only when there is no email. |
| name | optional | Shown in the email greeting. |
| sendEmail | default true | false = no email, you send the link yourself (WhatsApp, SMS, your own email tool). |
| resend | default false | true = 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
| 200 | issued | New coupon for this person (emailed unless sendEmail is false). |
| 200 | already_issued | They had one already: same coupon back, no second email unless resend is true. Webhook retries are safe. |
| 409 | out_of_coupons | Campaign and account are out of coupons. When only the campaign is out, a new coupon is made from your plan or pack. |
| 410 | campaign_expired | Issue from a campaign that has not ended. |
| 502 | email_failed | The email did not go out, so nobody got the coupon. Safe to retry. |
| 404 | campaign_not_found | Check 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.
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"
}
}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
| 200 | redeemed | Done. Apply the discount. |
| 409 | already_redeemed | Used before (or by a concurrent call). Do not apply. |
| 410 | expired | Campaign expiry passed. |
| 404 | not_found | Unknown code. |
Safe to retry on network errors: a repeated redeem is a 409, never a second redemption.
| 401 | missing_api_key / invalid_api_key | Check the header and that the key is not revoked. |
| 403 | plan_required | Account no longer on a plan with API access. |
| 400 | missing_code / missing_campaign_id / missing_recipient / invalid_email / invalid_phone | The message says which field to fix. |
| 429 | rate_limited | Back 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.