{
"program": {
"id": "lprg_3e8a1c74d952",
"name": "Coffee Club",
"status": "ACTIVE",
"start_date": "2026-01-01T00:00:00.000Z",
"end_date": null,
"validity_hours": {
"type": "ANY_TIME"
},
"metadata": {
"region": "EMEA"
},
"created_at": "2026-01-01T09:00:00.000Z",
"updated_at": "2026-09-09T10:16:12.284Z",
"object": "program"
},
"tier_structure": {
"id": "lts_3e8a1c74d952",
"name": "Coffee Club tiers",
"type": "POINT_BALANCE",
"point_balance": {
"card_definition_id": "lcdef_6a2d9f41c783"
},
"expiration": {
"type": "NO_RETENTION"
},
"downgrade": {
"type": "SINGLE_LEVEL"
},
"metadata": {
"region": "EMEA"
},
"status": "ACTIVE",
"created_at": "2026-09-09T10:15:43.091Z",
"updated_at": "2026-09-09T10:16:12.284Z",
"object": "tier_structure"
},
"program_tier_structure": {
"tier_structure_id": "lts_3e8a1c74d952",
"created_at": "2026-09-09T10:15:43.091Z",
"object": "program_tier_structure"
}
}Tier structure assigned
Event data sent for a Loyalty v2 vl.tier_structure.assigned activity handled by Workflows
WEBHOOK
vl.tier_structure.assigned
{
"program": {
"id": "lprg_3e8a1c74d952",
"name": "Coffee Club",
"status": "ACTIVE",
"start_date": "2026-01-01T00:00:00.000Z",
"end_date": null,
"validity_hours": {
"type": "ANY_TIME"
},
"metadata": {
"region": "EMEA"
},
"created_at": "2026-01-01T09:00:00.000Z",
"updated_at": "2026-09-09T10:16:12.284Z",
"object": "program"
},
"tier_structure": {
"id": "lts_3e8a1c74d952",
"name": "Coffee Club tiers",
"type": "POINT_BALANCE",
"point_balance": {
"card_definition_id": "lcdef_6a2d9f41c783"
},
"expiration": {
"type": "NO_RETENTION"
},
"downgrade": {
"type": "SINGLE_LEVEL"
},
"metadata": {
"region": "EMEA"
},
"status": "ACTIVE",
"created_at": "2026-09-09T10:15:43.091Z",
"updated_at": "2026-09-09T10:16:12.284Z",
"object": "tier_structure"
},
"program_tier_structure": {
"tier_structure_id": "lts_3e8a1c74d952",
"created_at": "2026-09-09T10:15:43.091Z",
"object": "program_tier_structure"
}
}The
This event can trigger a workflow when Loyalty activity is configured with the Tier structures group and the
vl.tier_structure.assigned event indicates that a Loyalty v2 tier structure was assigned to a program.
This page documents only the event data nested under
data. See Introduction to webhooks for the shared webhook structure, and Workflows webhooks for the full Workflows webhook payload.vl.tier_structure.assigned activity type. If the workflow reaches a Webhook callout action, Voucherify sends a webhook to the action’s target URL.
The example shows the content of data. It contains snapshots recorded with the activity. It is not wrapped in an activity property.
This operation also creates a separate vl.program.tier_structure.assigned activity. Use the Program tier structure assigned event to handle that event type.Body
application/json
Event data object schema for vl.tier_structure.assigned.
Loyalty v2 program snapshot recorded with the activity.
Show child attributes
Show child attributes
Tier structure resource.
Show child attributes
Show child attributes
Assignment of a tier structure to a Loyalty v2 program.
Show child attributes
Show child attributes
Response
Webhook accepted
Last modified on September 25, 2026