Creates a tier.
The name for a tier and the amount of required points to qualify for a tier can only exist for a single tier.
Attempts to create a tier with a tierDefinition.name
or requiredPoints
that already exists will return an error.
To create up to 20 tiers at once, use Bulk Create Tiers.
Note: You must have a Business VIP Premium plan or a Scale Premium plan to add tiers.
You can only call this method when authenticated as a Wix app or Wix user identity.
Tier to create.
Created loyalty tier.
curl -X POST \
'https://www.wixapis.com/loyalty-tiers/v1/tiers' \
-H 'Authorization: <AUTH>'
-H 'Content-Type: application/json' \
--data-raw '{
"tier": {
"tierDefinition": {
"name": "Gold",
"description": "Earn 2x points and get special discount",
"icon": {
"url": "shapes/39dce0a5d1ce498f95526b1390eaf585.svg"
}
},
"requiredPoints": 200
}
}'
{
"id": "acddc0e0-5e27-4a1b-a52d-b3785ac258cb",
"tierDefinition": {
"icon": {
"id": "",
"url": "shapes/39dce0a5d1ce498f95526b1390eaf585.svg",
"height": 0,
"width": 0
},
"name": "Gold",
"description": "Earn 2x points and get special discount"
},
"requiredPoints": 200,
"revision": "1",
"createdDate": "2024-02-15T14:22:02.539Z",
"updatedDate": "2024-04-17T11:34:25.274Z"
}
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.