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

    name rewardName (string)required

    Possible values: <= 32 characters

    Name of the reward

    maxClaims integernullable

    Maximum number of times this reward can be redeemed.

    rewardTypeId rewardTypeId (string)required

    Unique identifier for RewardType

    description stringrequired

    Detailed description of 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

    requiredPoints integer

    Possible values: <= 1000000

    Points required to claim the reward

    projectId stringrequired

    ID of the project associated with the reward

    id rewardId (string)

    Unique identifier for Reward

    thumbnail urinullable

    Optional URL for the reward's thumbnail image.

    userRewardsLimit integer

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

Responses​

Reward successfully created

Schema

    userRewardCount integer

    Number of times this reward has been redeemed.

    expiresAt date-timenullable

    Expiration date for special rewards

    name rewardName (string)required

    Possible values: <= 32 characters

    Name of the reward

    maxClaims integernullable

    Maximum number of times this reward can be redeemed.

    createdAt date-time

    Time representation of entity creation

    rewardTypeId rewardTypeId (string)required

    Unique identifier for RewardType

    description stringrequired

    Detailed description of 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

    requiredPoints integer

    Possible values: <= 1000000

    Points required to claim the reward

    myUserRewardCount integer

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

    projectId stringrequired

    ID of the project associated with the reward

    id rewardId (string)

    Unique identifier for Reward

    thumbnail urinullable

    Optional URL for the reward's thumbnail image.

    userRewardsLimit integer

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

Loading...