Benefit Definitions

What is a benefit definition?

Much like achievement definitions, benefit definitions are a configurable 'template' used when adding a benefit. Use Add Benefit Definition to create a benefit definition. After this, you can then Add Benefit using your newly created definition.

📘

More information about benefits

Additional information about benefits can be found on the Omneo [helpcenter] (https://help.omneo.io/hc/en-au/articles/360000038395-Benefits)

Benefit definition properties

AttributeDescription
id
INTEGER
READ-ONLY
The unique Omneo ID of the definition
name
STRING
The display name of the definition
handle
STRING
The unique handle for the definition
period
INTEGER
Valid for (in Days)
description
STRING
The internal description for the definition
internal_notes
STRING
Internal notes against this definition
short_description
STRING
A publicly available short description for this definition
long_description
STRING
A publicly available full HTML description for this definition
terms_conditions
STRING
Terms and conditions attached to this condition
redeem_instructions_store
STRING
Instructions to redeem in a physical store
redeem_instructions_online
STRING
Instructions to redeem online
redeem_code_pos
STRING
A redemption code used at the Point of Sale
redeem_code_online
STRING
A redemption code used Online
icon
URL
A valid URL for the icon associated with this definition
image_url
URL
A valid URL for the cover image associated with this definition
max_redemptions
INTEGER
The total redemptions available for an individual
is_extendable
BOOLEAN
Denotes whether this definition's end date can be extended
is_assignable
BOOLEAN
Denotes whether this definition can be assigned to an Omneo profile
is_reassignable
BOOLEAN
Denotes whether this benefit can be reassigned once already assigned to a profile
is_published
BOOLEAN
Denotes whether this benefit is published and is visible to the customer
is_archived
BOOLEAN
Denotes whether this benefit has been archived, and no longer available for use
tags
ARRAY
An array of tags associated with the benefit
is_claimable
BOOLEAN
Denotes whether this benefit can be claimed by a customer, this is different to redeeming.
Further information about claiming a benefit [here] (https://help.omneo.io/hc/en-au/articles/360001389876-Claim-Benefit-)
max_global_redemptions
INTEGER
The global maximum amount this benefit can be redeemed.
total_global_redemptions_remaining
INTEGER
The amount of global redemptions remaining for this definition
total_global_redemptions
INTEGER
The amount of times this benefit has been redeemed
total_global_created
INTEGER
The amount of times this benefit has been assigned to a profile
claim_period_start_at
STRING
DATE-TIME
The start date when customers can begin claiming the benefit (if is_claimable is true)
claim_period_end_at
STRING
DATE-TIME
The end date when customers can no longer claim the benefit (if is_claimable is true)
claim_condition
ARRAY
An array of attributes that must be available on the profile to be assigned.
For example, the Tier must be level 2, or the Joined location must be specific.
is_reclaimable
BOOLEAN
Denotes whether this benefit can be reclaimed by the same profile, once already claimed.
notify_schedule_offset
INTEGER
Offset the calculated schedule time from offset_days, offset_hours.
this value is subtracted from the scheduled time (in hours)
notify_issue_offset_days
INTEGER
An notification after the reward is issued
Send X Days after the issue
notify_issue_offset_hour
INTEGER
Send at X Hour of the day
notify_remind_offset_days
INTEGER
An expiry reminder offset in days
Send X Days after the end_date
notify_remind_offset_hour
INTEGER
Send at X Hour of the day
notify_extend_offset_days
INTEGER
An extension reminder usually sent before expiry
Send X Days after the end_date
notify_extend_offset_hour
INTEGER
Send at X Hour of the day
remind_target_id
INTEGER
the target id used when an reminder notification is triggered
extend_target_id
INTEGER
the target id used when an extension notification is triggered
issue_target_id
INTEGER
the target id used when an issued notification is triggered
end_at
INTEGER
The end (or expiry) date of the definition
total_allocations
INTEGER
The total allocations for this benefit
total_allocations_remaining
INTEGER
The total allocations remaining for this benefit
force_allocation
BOOLEAN
If this flag is true, this benefit can only be assigned to a profile via an allocation.
created_at
STRING
DATE-TIME
The UTC date & time the benefit record was created in ISO 8601 format.
updated_at
STRING
DATE-TIME
The UTC date & time the benefit record was last updated in ISO 8601 format.