Skip to main content
POST
Create a points adjustment

Authorizations

Api-Key
string
header
required

Body

application/json

Mint request details

userId
string<uuid>
required

The ID of the user receiving the points adjustment

amount
string
required

The adjustment amount in points, as a positive integer string. 1 point = 1 cent. Maximum 25,000 points per adjustment.

Pattern: ^[1-9][0-9]*$
type
enum<string>
required

The reason for minting points

Available options:
airdrop,
referral,
welcome,
manual
reason
string

A description of why points are being minted. Required for referral, airdrop, and manual types.

Required string length: 1 - 200

Response

Points adjustment created successfully

transactionId
string<uuid>

The ID of the created mint transaction

status
string

The adjustment transaction status. Adjustments are created as READY.

points
string

The number of points minted, as a string to preserve precision