curl --request POST \
--url 'https://gateway.amana.io/promo-codes/activate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"code": "<string>"
}'
import requests
url = "https://gateway.amana.io/promo-codes/activate"
headers = {"Authorization": "Bearer <token>", "Content-Type": "application/json"}
payload = {
"code": "<string>"
}
response = requests.request("POST", url, json=payload, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/promo-codes/activate', {
method: 'POST',
headers: {"Authorization": "Bearer <token>", "Content-Type": "application/json"},
body: JSON.stringify({"code": "<string>"}),
});
console.log(await response.json());
{
"ok": true,
"promoCode": "<string>",
"title": "<string>",
"termsAndConditionsLink": "<string>",
"amount": 123.45,
"currency": "<string>",
"criteria": [
{
"key": "<string>",
"label": "<string>",
"status": true,
"action": {
"label": {},
"deeplink": "<string>"
}
}
]
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Other
Activate promo code
Activate a promo code on the user’s account.
POST
/
promo-codes
/
activate
curl --request POST \
--url 'https://gateway.amana.io/promo-codes/activate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"code": "<string>"
}'
import requests
url = "https://gateway.amana.io/promo-codes/activate"
headers = {"Authorization": "Bearer <token>", "Content-Type": "application/json"}
payload = {
"code": "<string>"
}
response = requests.request("POST", url, json=payload, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/promo-codes/activate', {
method: 'POST',
headers: {"Authorization": "Bearer <token>", "Content-Type": "application/json"},
body: JSON.stringify({"code": "<string>"}),
});
console.log(await response.json());
{
"ok": true,
"promoCode": "<string>",
"title": "<string>",
"termsAndConditionsLink": "<string>",
"amount": 123.45,
"currency": "<string>",
"criteria": [
{
"key": "<string>",
"label": "<string>",
"status": true,
"action": {
"label": {},
"deeplink": "<string>"
}
}
]
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Body
Content type:application/json
string
required
One-time code the user received.
Response
200 Success.
boolean
Available options:
Truestring
string
string
number
string
Possible Errors
| Error | Possible cause | What to do |
|---|---|---|
| 400 | Invalid or missing field | Check the request against the schema. |
| 401 | Token missing or expired | Log in again or use the refresh token. |
| 403 | IP not whitelisted, or account restricted | Confirm your IP is whitelisted; otherwise contact Amana. |
| 429 / 5xx | Rate limit, or temporary issue on our side | Retry with backoff; contact support if it persists. |
curl --request POST \
--url 'https://gateway.amana.io/promo-codes/activate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"code": "<string>"
}'
import requests
url = "https://gateway.amana.io/promo-codes/activate"
headers = {"Authorization": "Bearer <token>", "Content-Type": "application/json"}
payload = {
"code": "<string>"
}
response = requests.request("POST", url, json=payload, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/promo-codes/activate', {
method: 'POST',
headers: {"Authorization": "Bearer <token>", "Content-Type": "application/json"},
body: JSON.stringify({"code": "<string>"}),
});
console.log(await response.json());
{
"ok": true,
"promoCode": "<string>",
"title": "<string>",
"termsAndConditionsLink": "<string>",
"amount": 123.45,
"currency": "<string>",
"criteria": [
{
"key": "<string>",
"label": "<string>",
"status": true,
"action": {
"label": {},
"deeplink": "<string>"
}
}
]
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Last modified on October 8, 2026
