Webhook event field reference.

This page lists the exact fields in every webhook event. It is the companion to Events and member synchronization, which covers the catalog, the envelope, and how the pieces fit together; come here when you need the precise shape of one event's data block.

Each group opens with one generated example, then a table per event. Types read as follows: member is the two-value member object (id plus unique_identifier), string (UUID) a record id, integer a whole number, and business time the timezone-plus-date object. Both the member object and business time are described on the events page. "Null" tells you whether the field can be JSON null. A field declared for an event is always present; when a value does not apply, or an older record never stored it, it is null rather than absent.

Event payloads

Points and rewards payloads

A points.transferred example:

{
  "card_id": "822570e3-f2b1-4b08-851c-e16ca3beac0f",
  "sender": {
    "id": "c54f3c5a-2470-4b38-be0c-786af120164a",
    "unique_identifier": "SAMPLE-0001"
  },
  "receiver": {
    "id": "1f6654d5-f0a2-4481-940b-ba74dc76d3b6",
    "unique_identifier": "SAMPLE-0001"
  },
  "sender_transaction_id": "d3b28ee5-6b69-4baa-bb28-f8041f0c67c9",
  "receiver_transaction_id": "e1fba76f-105a-4dbc-bc0b-e79936270e0d",
  "points_transferred": 20,
  "source": "member"
}

points.earned

points.spent

purchase.recorded

points.adjusted

points.reversed

points.expired

This event is the only signal for expiry; an expiry never sends points.spent.

points.transferred

Sent once per transfer. The receiver's points.earned and the sender's points.spent arrive as separate deliveries under the same correlation_id.

points.code_redeemed

reward.redeemed

Stamps payloads

A stamp.expired example:

{
  "member": {
    "id": "dbc26b96-3344-41f0-8e25-e9ba7850e33d",
    "unique_identifier": "SAMPLE-0001"
  },
  "stamp_card_id": "9547be32-f42c-4578-a7f7-1e2e983d2241",
  "transaction_id": "cb4131c1-6e9d-4bab-97ee-c823f04276b6",
  "stamps_expired": 6,
  "stamps_delta": -6,
  "stamps_after": 0,
  "expired_at": "2026-07-10T03:00:00Z",
  "business_time": {
    "timezone": "Europe/Amsterdam",
    "local_date": "2026-07-10"
  }
}

stamp.added

stamp_card.completed

stamp.reward_redeemed

stamp.adjusted

stamp.voided

stamp.expired

Vouchers payloads

A voucher.issued example:

{
  "member": {
    "id": "748d9494-82de-41c3-aca8-3257881e216a",
    "unique_identifier": "SAMPLE-0001"
  },
  "voucher_id": "faf2c99b-1eeb-49f6-a2fa-aa2921535240",
  "source_voucher_id": "22b5a0e3-3810-4d81-a49c-a83cbee6faaa",
  "source": "birthday",
  "issued_at": "2026-07-10T03:15:00Z",
  "valid_from": "2026-07-10T00:00:00Z",
  "valid_until": "2026-07-16T23:59:59Z",
  "business_time": {
    "timezone": "Europe/Amsterdam",
    "local_date": "2026-07-10"
  }
}

voucher.redeemed

The voucher code value is never sent.

voucher.claimed

Sent once per new voucher-member relationship. Re-saving a voucher the member already holds sends nothing.

voucher.issued

voucher.redemption_voided

voucher.exhausted

A shared voucher has no single member, so this event carries no member field.

Passes payloads

A pass.issued example:

{
  "member": {
    "id": "fb5d5784-8be5-4f77-8b98-5aa4f7407414",
    "unique_identifier": "SAMPLE-0001"
  },
  "member_pass_id": "07df8be8-9243-4425-93a0-85d5183c8e6f",
  "prepaid_pass_id": "2eeb0db3-819f-4649-829c-22489d055e8b",
  "uses_total": 10,
  "price_minor": 8900,
  "currency": "EUR",
  "valid_from": "2026-07-10T12:00:00Z",
  "valid_until": "2026-08-08T21:59:59Z",
  "business_time": {
    "timezone": "Europe/Amsterdam",
    "local_date": "2026-07-10"
  }
}

pass.issued

pass.used

pass.use_voided

pass.used_up

pass.expired

Members and tiers payloads

A member.tier_changed example:

{
  "member": {
    "id": "b1e4f069-9b21-4b0c-b2f4-063209f55deb",
    "unique_identifier": "SAMPLE-0001"
  },
  "club_id": "c90d4040-dfdf-43bb-a608-924ea876bdd6",
  "previous_tier_id": "c4051af7-a81e-4e8b-8069-3827c4dff110",
  "previous_level": 1,
  "new_tier_id": "6148c869-6af9-4b87-ab2a-cf71d44cf394",
  "new_level": 2,
  "direction": "upgraded",
  "changed_at": "2026-07-10T17:45:00Z"
}

member.enrolled

Exactly one of card_id or stamp_card_id is present, never both.

member.unenrolled

member.tier_changed

Tier names are edited, translated labels, so they make unstable machine keys; the payload carries ids and levels instead.

Member cards payloads

A member_card.disabled example:

{
  "member": {
    "id": "3ae5af8f-d735-4110-9154-ae94c959f594",
    "unique_identifier": "SAMPLE-0001"
  },
  "member_card_id": "2d64f9a3-4c02-456d-8d37-77a31c6d7d1a",
  "disabled_at": "2026-07-10T17:45:00Z",
  "reason_code": "partner_disabled",
  "status": "disabled"
}

member_card.issued

member_card.claimed

member_card.disabled

The physical card number, its QR value, and its claim link never appear in any webhook.

Privacy payloads

The member.relationship_removed example:

{
  "member": {
    "id": "1e3bddd3-de01-4d1c-9707-b2fbcbb1f89c",
    "unique_identifier": "SAMPLE-0001"
  },
  "removal_id": "6fb25576-db8e-4d03-8d05-8b6e2afbebe5",
  "scope": "partner_relationship",
  "requested_at": "2026-07-10T17:45:00Z"
}

member.relationship_removed

Related topics

• Events and member synchronization: The catalog, the envelope, the member object, money, and timestamps
• Webhooks overview and setup: Turn on Webhooks and add your first endpoint
• Security and signature verification: Verify a delivery came from Reward Loyalty
• Deliveries, retries, and troubleshooting: Test sends, retries, auto-pause, and duplicates