v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01934981.1 MB

Tier Structures

Activate tier structure

<Badge color="yellow">BETA endpoint</Badge>

This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.

</Warning>

Moves the tier structure to the ACTIVE status. Allowed state transitions: DRAFT -> ACTIVE and INACTIVE -> ACTIVE. No request body.

post/v2/loyalties/tier-structures/{tierStructureId}/activate

Path parameters

idstring required

Unique tier structure identifier.

Response

The activated tier structure.

idstring required

Unique tier structure identifier.

namestring required

Display name of the tier structure.

type'POINT_BALANCE' | 'POINT_EARNED' required

Tier qualification tracking model.

metadataobject required

Free-form key/value object holding custom attributes. Defaults to {}.

status'DRAFT' | 'ACTIVE' | 'INACTIVE' | 'DELETED' required

Current lifecycle status of the tier structure.

created_atstring date-time required

Creation timestamp (ISO 8601).

updated_atstring date-time nullable required

Last update timestamp (ISO 8601), or null if never updated.

object'tier_structure' required

Object type discriminator. Always tier_structure.