POST
/
rewards
/
grant
curl https://api.thanxsandbox.com/rewards/grant \
  -X POST \
  -H "Content-Type: application/json"  \
  -H "Accept-Version: v4.0" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ${token}" \
  -H "X-ClientId: ${client_id}" 

{
  "reward": {
    "id": "222441e34626",
    "olo_uid": "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmn",
    "user_id": "werofsdf",
    "merchant_id": "weroif",
    "campaign_id": "85133c3c1258",
    "state": "available",
    "earn": {
      "type": "intro"
    },
    "redeem": {
      "type": "manual",
      "text": "$10 off",
      "detail": "Long description",
      "window": 60,
      "venue": "all"
    },
    "coupon_code": {
      "code": null,
      "type": null,
      "display": null
    },
    "fine_print": "Can't be used for alcohol purchases",
    "instructions": "Example staff instructions",
    "available_at": "2019-12-25T19:00:00Z",
    "activated_at": "2020-01-01T20:00:00Z",
    "retire_at": null,
    "used_at": null,
    "images": {
      "index": {
        "small": "https://...png",
        "large": "https://...png"
      },
      "detail": {
        "small": "https://...png",
        "large": "https://...png"
      },
      "advertising": {
        "small": "https://...png",
        "large": "https://...png"
      }
    },
    "uses_dynamic_coupon_codes": false
  }
}
Please review proper request headers here.
This endpoint is only available in SANDBOX

​
Parameters

​
campaign_id
string
required
The campaign id to grant the reward for
​
user_id
string
required
The user to grant the reward for

​
Response

​
id
string
Reward ID
​
olo_uid
string
Developers that do not communicate directly with the Olo APIs can ignore this field.The field is only present for merchants that have integrated with Olo. This UID should be used instead of the Reward ID when attempting to apply a reward to the basket when communicating directly with the Olo API.This UID can also be used to match records (via the externalreference Olo rewards API attribute) being returned by the Olo API to relevant reward or points product records in the Thanx API.
​
user_id
string
User ID
​
merchant_id
string
Merchant ID
​
campaign_id
string
Campaign ID
​
state
enum
Reward State (available, active, used)
​
fine_print
string
Fine print for the reward
​
instructions
string
Staff instructions for the reward
​
available_at
string
Time the reward was given to the user in ISO8601-format
​
activated_at
string
Time the reward was activated in ISO8601-format
​
used_at
string
Time the reward was marked as used in ISO8601-format
​
retire_at
string
Time the reward will be automatically retired in ISO8601-format
​
coupon_code
string
This hash will be populated if the reward is 'active' or 'used' and the merchant uses coupon codes.
​
earn
string
Details of how the reward was earned
​
redeem
string
Details of how the reward can be redeemed
​
images
hash
Each of these values is a URL of the reward image with the aspect ratio preserved. Each property (EG: index.small) has a set width for all rewards, and the height varies based on the aspect ratio.For example, if you import an image with the dimensions 1000x1000 (aspect ratio of 1:1), then the image for index.small has the dimensions 563x563 because it matches the original aspect ratio.
​
redemption_location_id
string
Location ID where the reward was activated at
​
uses_dynamic_coupon_codes
boolean
Indicates whether this reward uses dynamically generated coupon codes. When true, a unique coupon code will be generated from a coupon pool when the reward is activated. This field is relevant for rewards created from points products or campaigns with dynamic coupon pools.
curl https://api.thanxsandbox.com/rewards/grant \
  -X POST \
  -H "Content-Type: application/json"  \
  -H "Accept-Version: v4.0" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ${token}" \
  -H "X-ClientId: ${client_id}" 

{
  "reward": {
    "id": "222441e34626",
    "olo_uid": "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmn",
    "user_id": "werofsdf",
    "merchant_id": "weroif",
    "campaign_id": "85133c3c1258",
    "state": "available",
    "earn": {
      "type": "intro"
    },
    "redeem": {
      "type": "manual",
      "text": "$10 off",
      "detail": "Long description",
      "window": 60,
      "venue": "all"
    },
    "coupon_code": {
      "code": null,
      "type": null,
      "display": null
    },
    "fine_print": "Can't be used for alcohol purchases",
    "instructions": "Example staff instructions",
    "available_at": "2019-12-25T19:00:00Z",
    "activated_at": "2020-01-01T20:00:00Z",
    "retire_at": null,
    "used_at": null,
    "images": {
      "index": {
        "small": "https://...png",
        "large": "https://...png"
      },
      "detail": {
        "small": "https://...png",
        "large": "https://...png"
      },
      "advertising": {
        "small": "https://...png",
        "large": "https://...png"
      }
    },
    "uses_dynamic_coupon_codes": false
  }
}