POST

Bulk Create Tiers


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.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Loyalty
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/loyalty-tiers/v1/bulk/tiers/create

Body Params
tiersArray <Tier>minItems 1maxItems 20

Tiers to create.

Response Object
resultsArray <BulkTierResult>

Created tiers.


bulkActionMetadataBulkActionMetadata

Bulk action metadata.

Bulk create tiers
Request
cURL
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 } ] }'
Response
JSON
{ "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 } }
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?