Skip to main content

Create a new reward

POST 
/reward

Create a new reward

Request​

Body

Data for creating a new reward

    expiresAt date-timenullable

    Expiration date for special rewards

    rewardTypeId rewardTypeId (string)required

    Unique identifier for RewardType

    projectId stringrequired

    ID of the project associated with the reward

    requiredPoints integer

    Possible values: <= 1000000

    Points required to claim the reward

    rankOrder integer

    The order in which the reward should be displayed

    data stringnullable

    Additional JSON metadata for triggers, actions or general easy-access data

    userRewardsLimit integer

    Maximum allowed number of times for the reward to be redeemed by a single user

    thumbnail urinullable

    Optional URL for the reward's thumbnail image.

    maxClaims integernullable

    Maximum number of times this reward can be redeemed.

    id rewardId (string)

    Unique identifier for Reward

    name rewardName (string)required

    Possible values: <= 32 characters

    Name of the reward

    description stringrequired

    Detailed description of the reward

Responses​

Reward successfully created

Schema

    expiresAt date-timenullable

    Expiration date for special rewards

    rewardTypeId rewardTypeId (string)required

    Unique identifier for RewardType

    projectId stringrequired

    ID of the project associated with the reward

    userRewardCount integer

    Number of times this reward has been redeemed.

    requiredPoints integer

    Possible values: <= 1000000

    Points required to claim the reward

    rankOrder integer

    The order in which the reward should be displayed

    data stringnullable

    Additional JSON metadata for triggers, actions or general easy-access data

    myUserRewardCount integer

    Number of times this reward has been redeemed by the current user.

    userRewardsLimit integer

    Maximum allowed number of times for the reward to be redeemed by a single user

    thumbnail urinullable

    Optional URL for the reward's thumbnail image.

    createdAt date-time

    Time representation of entity creation

    maxClaims integernullable

    Maximum number of times this reward can be redeemed.

    id rewardId (string)

    Unique identifier for Reward

    name rewardName (string)required

    Possible values: <= 32 characters

    Name of the reward

    description stringrequired

    Detailed description of the reward

Loading...