Tokens/Points
Creates a new order for a points campaign. This endpoint is used when you want to award specific points to recipients.
Authorizations
Path parameters
campaignPointsIdstringRequiredExample:
The unique identifier for the points campaign
campaign_456
Body
contactsstring · email[]RequiredExample:
Recipients of the order as email addresses
[email protected]
titlestringOptionalExample:
Optional title for the order
Gold Points Reward
descriptionstringOptionalExample:
Optional description for the order
Reward for completing the survey
Responses
201
Order created successfully
application/json
400
Bad Request - Missing or invalid parameters
application/json
401
Unauthorized - API key is missing or invalid
application/json
404
Campaign not found
application/json
post
POST /api/v1/gcm/reseller/campaign/{campaignPointsId}/order HTTP/1.1
Host: api.giftoin.org
x-gft_api_key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 304
{
"contacts": [
"[email protected]"
],
"thirdPartyUserIds": [
{
"type": "discord",
"id": "123456789012345678"
}
],
"title": "Gold Points Reward",
"description": "Reward for completing the survey",
"items": {
"points": [
{
"id": "point_789",
"quantity": 100
}
]
},
"metadata": {
"source": "winter_promotion",
"department": "marketing"
}
}
{
"orderId": "order_12345",
"status": "created"
}
API Reference Notice
We are currently experiencing a technical issue with the API reference display in GitBook. For the most accurate and complete API documentation, please refer to our official API reference on Postman.
We apologize for any inconvenience and are working to resolve this issue. Thank you for your understanding.
Last updated
Was this helpful?