Skip to main content

Create a new reward

POST 
/reward

Create a new reward

Request​

Body

Data for creating a new reward

    description string

    Detailed description of the reward

    thumbnail urinullable

    Optional URL for the reward's thumbnail image.

    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

    rewardTypeId rewardTypeId (string)required

    Unique identifier for RewardType

    projectId stringrequired

    ID of the project associated with the reward

    expiresAt date-timenullable

    Expiration date for special rewards

    rankOrder integer

    The order in which the reward should be displayed

    id rewardId (string)

    Unique identifier for Reward

    name rewardName (string)required

    Possible values: <= 32 characters

    Name of the reward

    maxClaims integernullable

    Maximum number of times this reward can be redeemed.

    requiredPoints integer

    Possible values: <= 1000000

    Points required to claim the reward

Responses​

Reward successfully created

Schema

    description string

    Detailed description of the reward

    thumbnail urinullable

    Optional URL for the reward's thumbnail image.

    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

    rewardTypeId rewardTypeId (string)required

    Unique identifier for RewardType

    projectId stringrequired

    ID of the project associated with the reward

    expiresAt date-timenullable

    Expiration date for special rewards

    rankOrder integer

    The order in which the reward should be displayed

    id rewardId (string)

    Unique identifier for Reward

    name rewardName (string)required

    Possible values: <= 32 characters

    Name of the reward

    myUserRewardCount integer

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

    maxClaims integernullable

    Maximum number of times this reward can be redeemed.

    userRewardCount integer

    Number of times this reward has been redeemed.

    createdAt date-time

    Time representation of entity creation

    requiredPoints integer

    Possible values: <= 1000000

    Points required to claim the reward

Loading...