Left

Event data sent for a Loyalty v2 LEFT transaction handled by Workflows

WEBHOOK LEFT

LEFT

{
  "transaction": {
    "id": "lttx_6a2d9f41c783",
    "card_id": "lcrd_28c4e7b195fa",
    "program_id": "lprg_3e8a1c74d952",
    "member_id": "lmbr_91f6b2e84a37",
    "card_definition_id": "lcdef_6a2d9f41c783",
    "tier_structure_id": "lts_3e8a1c74d952",
    "tier_id": null,
    "status": "APPROVED",
    "created_at": "2026-09-09T10:15:43.091Z",
    "updated_at": "2026-09-09T10:15:43.284Z",
    "object": "tier_transaction",
    "type": "LEFT",
    "details": {
      "points": 0,
      "tier_from": "lt_6a2d9f41c783",
      "tier_to": null,
      "origin": {
        "type": "member_card_deleted"
      },
      "rejection": null,
      "start_at": null,
      "expires_at": null
    }
  }
}

The LEFT event indicates that a member left a Loyalty v2 tier and does not qualify for any other tier in the tier structure.

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 LEFT 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.

Voucherify creates this transaction when a member who has a tier no longer qualifies for any tier. If a lower tier still applies, Voucherify creates a DOWNGRADED transaction instead. The LEFT transaction is created when:

• The member’s point balance or points earned in the tracking period drop below the minimum of every tier. Depending on your tier structure configuration, the member may still qualify for a tier despite the point balance being below the minimum.
• The member’s tier retention period ends, and the member does not qualify for any tier.
• The member no longer matches the segments required by a tier with segment qualification rules and does not qualify for any other tier.

details.tier_to is null. details.tier_from is the left tier ID. transaction.tier_id is null.

Body

application/json

Event data object schema for LEFT.

transaction · Loyalty Tier Left Transaction · object · required

A Loyalty v2 tier transaction with the LEFT type.

Show child attributes

Response

200

Webhook accepted