bulkCreateTiers( )


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.

Authentication

This function requires elevated permissions and runs only on the backend and on dashboard pages.

Permissions
Manage Loyalty
Learn more about app permissions.
Method Declaration
Copy
function bulkCreateTiers(tiers: Array<Tier>): Promise<BulkCreateTiersResponse>;
Method Parameters
tiersArray<Tier>Required

Tiers to create.

Returns
Return Type:Promise<BulkCreateTiersResponse>
JavaScript
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 * } * } * ] * } */
Errors

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

Did this help?