Skip to main content

Create a new reward

POST 
/reward

Create a new reward

Request​

Body

Data for creating a new reward

    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.

    expiresAt date-timenullable

    Expiration date for special rewards

    rewardTypeId rewardTypeId (string)required

    Unique identifier for RewardType

    rankOrder integer

    The order in which the reward should be displayed

    name rewardName (string)required

    Possible values: <= 32 characters

    Name of the reward

    description string

    Detailed description of the reward

    requiredPoints integer

    Possible values: <= 1000000

    Points required to claim the reward

    projectId stringrequired

    ID of the project associated with the reward

    maxClaims integernullable

    Maximum number of times this reward can be redeemed.

    id rewardId (string)

    Unique identifier for Reward

Responses​

Reward successfully created

Schema

    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.

    expiresAt date-timenullable

    Expiration date for special rewards

    rewardTypeId rewardTypeId (string)required

    Unique identifier for RewardType

    myUserRewardCount integer

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

    rankOrder integer

    The order in which the reward should be displayed

    name rewardName (string)required

    Possible values: <= 32 characters

    Name of the reward

    description string

    Detailed description of the reward

    createdAt date-time

    Time representation of entity creation

    requiredPoints integer

    Possible values: <= 1000000

    Points required to claim the reward

    projectId stringrequired

    ID of the project associated with the reward

    maxClaims integernullable

    Maximum number of times this reward can be redeemed.

    userRewardCount integer

    Number of times this reward has been redeemed.

    id rewardId (string)

    Unique identifier for Reward

Loading...