POST
/
api
/
loyalty
/
rules
/
{id}

Authorizations

X-API-KEY
string
headerrequired

Path Parameters

id
string
required

Body

application/json
name
string
required

Name of the loyalty rule

Minimum length: 1
startTime
string | null
required

Start time for the loyalty rule

endTime
string | null
required

End time for the loyalty rule

effectiveStartTime
required

Effective start time of the rule

effectiveEndTime
required

Effective end time of the rule

amount
any | null
required

Reward amount for the loyalty rule

metadata
object
required

Additional metadata for the loyalty rule

frequency
enum<string>
required

Frequency of the rule execution

Available options:
none,
once,
daily,
weekly,
monthly,
immediately
description
string

Optional description of the loyalty rule

customRewardsCsvUrl
string | null

URL for uploading custom rewards via CSV

customRewardsApiUrl
string | null

API URL for custom rewards integration

subscriptionIdentifier
string | null

Optional subscription identifier for the rule

hideInUi
boolean
default: false

Whether to hide this rule in the user interface

isRequired
boolean
default: false

Whether this rule is required for participation

oauthCredentialsId
string | null

ID for associated OAuth credentials

rewardType
enum<string>
default: points

Type of reward issued by this rule

Available options:
points,
multiplier
interval
enum<string> | null

Time interval for recurring rule execution

Available options:
daily,
weekly,
monthly,
once
loyaltyRuleGroupId

ID of the rule group section to associate with the rule

Response

200 - application/json
id
string
required
name
string
required

Name of the loyalty rule

Minimum length: 1
startTime
string | null
required

Start time for the loyalty rule

endTime
string | null
required

End time for the loyalty rule

effectiveStartTime
required

Effective start time of the rule

effectiveEndTime
required

Effective end time of the rule

amount
any | null
required

Reward amount for the loyalty rule

metadata
object
required

Additional metadata for the loyalty rule

frequency
enum<string>
required

Frequency of the rule execution

Available options:
none,
once,
daily,
weekly,
monthly,
immediately
description
string

Optional description of the loyalty rule

customRewardsCsvUrl
string | null

URL for uploading custom rewards via CSV

customRewardsApiUrl
string | null

API URL for custom rewards integration

subscriptionIdentifier
string | null

Optional subscription identifier for the rule

hideInUi
boolean
default: false

Whether to hide this rule in the user interface

isRequired
boolean
default: false

Whether this rule is required for participation

oauthCredentialsId
string | null

ID for associated OAuth credentials

rewardType
enum<string>
default: points

Type of reward issued by this rule

Available options:
points,
multiplier
interval
enum<string> | null

Time interval for recurring rule execution

Available options:
daily,
weekly,
monthly,
once
loyaltyRuleGroupId

ID of the rule group section to associate with the rule