{
"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"
}
}Program tier structure assigned
Event data sent for a Loyalty v2 vl.program.tier_structure.assigned activity handled by Workflows
WEBHOOK
vl.program.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 Programs group and the
vl.program.tier_structure.assigned event indicates that a tier structure was assigned to a Loyalty v2 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.program.tier_structure.assigned activity type. If the workflow reaches a Webhook callout action, Voucherify sends a webhook to the action’s target URL.
Workflows send this activity in the data.trigger object.
This operation also creates a separate vl.tier_structure.assigned activity. Use the Tier structure assigned event to handle that event type.Body
application/json
Event data object schema for vl.program.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