Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.omneo.io/llms.txt

Use this file to discover all available pages before exploring further.

What is a reward definition?

A reward definition is a configurable template, containing core information used when assigning a reward. To redeem a reward against a profile, you first need to specify the definition of the reward you are assigning. For example, you may have a “Birthday” reward definition, and a “Christmas” reward definition. When attributing the reward to a profile, you can specify your desired definition at the time of redemption.

Reward definition properties

AttributeDescription
id INTEGERThe unique Omneo ID of the definition
name STRINGThe display name of the definition
handle STRINGThe unique handle for the definition
period INTEGERValid for (in Days)
description STRINGThe internal description for the definition
short_description STRINGA publicly available short description for this definition
long_description STRINGA publicly available full HTML description for this definition
terms_conditions STRINGTerms and conditions attached to this condition
earn_instructions STRINGInstructions to customers on how to earn this reward
icon URLA valid URL for the icon associated with this definition
image_url URLA valid URL for the cover image associated with this definition
issue_target_id INTEGERThe target id used when an issued notification is triggered
expiry_target_id INTEGERthe target id used when an expiry notification is triggered
notify_issue_offset INTEGERIssue notification offset in hours
notify_expiry_offset INTEGERExpiry notification offset in hours
internal_notes STRINGInternal notes attached to this definition
type STRING ENUMThe type of the reward definition available values are: - activation - anniversary - birthday - bonus - campaign - customer-service - reactivation - spend - staff - system-adjustment - other
value FLOATThe value of the reward
is_extendable BOOLEANDenotes if this definition can be extended past the expiry date
is_assignable BOOLEANDenotes whether this definition can be allocated to a profile. Further information about assigning reward can be found in Rewards
is_reassignable BOOLEANDenotes whether this definition can be allocated to a profile when already allocated
is_published BOOLEANDenotes whether this definition is published and is visible to the customer
tags ARRAYAn Array of tags attached to this definition
created_at STRING DATE-TIMEThe UTC date & time the definition record was created in ISO 8601 format.
updated_at STRING DATE-TIMEThe UTC date & time the benefit definition was last updated in ISO 8601 format.