Creates up to 20 tiers.
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 a single tier, use Create Tier.
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.
Tiers to create.
Created tiers.
Bulk action metadata.
curl -X POST \
'https://www.wixapis.com/loyalty-tiers/v1/bulk/tiers/create' \
-H 'Authorization: <AUTH>'
-H 'Content-Type: application/json' \
--data-raw '{
"tiers": [
{
"tierDefinition": {
"name": "Gold",
"description": "Earn 2x points and get special discount",
"icon": {
"url": "shapes/39dce0a5d1ce498f95526b1390eaf585.svg"
}
},
"requiredPoints": 200
}
]
}'
{
"results": [
{
"item": {
"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"
},
"itemMetadata": {
"id": "d7dfacd5-8141-456b-b278-6383b97f2569",
"originalIndex": 0,
"success": true,
"error": null
}
}
],
"bulkActionMetadata": {
"totalSuccesses": 1,
"totalFailures": 0,
"undetailedFailures": 0
}
}
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.