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 createTier()
.
Note: You must have a Business VIP Premium plan or a Scale Premium plan to add tiers.
This function requires elevated permissions and runs only on the backend and on dashboard pages.
function bulkCreateTiers(tiers: Array<Tier>): Promise<BulkCreateTiersResponse>;
Tiers to create.
import { tiers } from "wix-loyalty.v2";
import { webMethod, Permissions } from "wix-web-module";
import { elevate } from "wix-auth";
/* Sample tiers object:
*
* {
* "tiers": [
* {
* "required_points": 50,
* "tierDefinition": {
* "name": "Elite Member Tier",
* "description": "Exclusive tier for elite members"
* }
* }
* ]
* }
*/
const elevatedBulkCreateTiers = elevate(tiers.bulkCreateTiers);
export const bulkCreateTiers = webMethod(Permissions.Anyone, async (tiers) => {
try {
const result = await elevatedBulkCreateTiers(tiers);
return result;
} catch (error) {
console.error(error);
// Handle the error
}
});
/* Promise resolves to:
*
* {
* "bulkActionMetadata": {
* "totalFailures": 0,
* "totalSuccesses": 1,
* "undetailedFailures": 0
* },
* "results": [
* {
* "item": {
* "tierDefinition": {
* "name": "Elite Member Tier",
* "description": "Exclusive tier for elite members"
* },
* "_createdDate": "2024-06-10T07:09:04.213Z",
* "_id": "dd43f55d-6d6f-45eb-b76e-13a161a436a1",
* "_updatedDate": "2024-06-10T07:09:04.213Z",
* "requiredPoints": 50,
* "revision": "1"
* },
* "itemMetadata": {
* "_id": "dd43f55d-6d6f-45eb-b76e-13a161a436a1",
* "originalIndex": 0,
* "success": true
* }
* }
* ]
* }
*/
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.