POST

Create Tier


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.

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/tiers

Body Params
tierTierRequired

Tier to create.

Response Object
tierTier

Created loyalty tier.

Create tier
Request
cURL
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 } }'
Response
JSON
{ "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" }
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?