Skip to main content
WEBHOOK
The UPGRADED event indicates that a member moved to a higher Loyalty v2 tier.
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.
This event can trigger a workflow when Loyalty transaction is configured with the Tier transactions group and the UPGRADED transaction type. If the workflow reaches a Webhook callout action, Voucherify sends a webhook to the action’s target URL. Workflows send this transaction in the data.trigger object. The example uses the APPROVED status. A workflow can filter the trigger by transaction status: PENDING, APPROVED, or REJECTED. The matched status is available in data.trigger.transaction.status; it does not create a separate event type. details.tier_from and details.tier_to are tier IDs. They are not nested tier objects.

Body

application/json

Event data object schema for UPGRADED.

transaction
Loyalty Tier Upgraded Transaction · object
required

A Loyalty v2 tier transaction with the UPGRADED type.

Response

Webhook accepted

Last modified on September 25, 2026