Reward schema

PropertyTypeDescription
idstringTremendous ID of the reward
order_idstringTremendous ID of the order this reward is part of.
created_atstring (date-time)Date the reward was created
campaign_idstringID of the campaign in your account, that defines the available products (different gift cards, charity, etc.) that the recipient can choose from.
productsarray of strings

List of IDs of product (different gift cards, charity, etc.) that will be available to the recipient to choose from.


Providing a products array will override the products made available by the campaign specified using the campaign_id property unless the products array is empty. It will not override other campaign attributes, like the message and customization of the look and feel.

valueobject
Show object properties
PropertyTypeDescription
denominationnumber (double)Amount of the reward
currency_codestringCurrency of the reward
recipientobject
Show object properties
PropertyTypeDescription
namestringName of the recipient
emailstringEmail address of the recipient
phonestringPhone number of the recipient. For non-US phone numbers, specify the country code (prefixed with +).
deliver_atstring (date)Timestamp of reward delivery within the next year. Note that if date-time is provided, the time values will be ignored.
custom_fieldsarray
Show array item type
PropertyTypeDescription
idstringTremendous ID of the custom field
valuestringValue of the custom field
labelstringLabel of the custom field
deliveryobject
Show object properties
PropertyTypeDescription
methodstring

How to deliver the reward to the recipient.

Delivery MethodDescription
EMAILDeliver the reward to the recipient by email
LINKDeliver the reward via a link, retrieved from /rewards or /rewards/{id} endpoint and delivered out-of-band.
PHONEDeliver the reward to the recipient by SMS
statusstring

Current status of the delivery of the reward:

  • SCHEDULED - Reward is scheduled for delivery and will be delivered soon.
  • FAILED - Delivery of reward failed (e.g. email bounced).
  • SUCCEEDED - Reward was successfully delivered.
  • PENDING - Delivery is pending but not yet scheduled.