{
"customer": {
"id": "cust_2p0TvCOvB25HWUrW9JFf4czJ",
"name": "Alex Doe",
"email": null,
"source_id": "4l3x-d03",
"metadata": {},
"object": "customer"
},
"campaign": {
"id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
"name": "Loyalty programme",
"campaign_type": "LOYALTY_PROGRAM",
"type": "AUTO_UPDATE",
"is_referral_code": false,
"voucher": {
"type": "LOYALTY_CARD",
"loyalty_card": {
"points": 0
},
"redemption": {
"quantity": null,
"redeemed_quantity": 0
},
"code_config": {
"length": 8,
"prefix": "",
"charset": "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ",
"pattern": "########",
"postfix": ""
}
},
"auto_join": true,
"join_once": true,
"active": true,
"category_id": null,
"category": null,
"metadata": {},
"start_date": null,
"expiration_date": null,
"description": null,
"created_at": "2024-01-18T15:18:38.577Z",
"updated_at": "2024-02-09T13:04:15.034Z",
"object": "campaign"
},
"loyalty_tier_from": {
"id": "ltr_0e30613ad01f044515",
"name": "Loyal silver",
"campaign_id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
"metadata": {},
"created_at": "2024-01-24T08:28:02.240Z",
"updated_at": null,
"earning_rules": {},
"rewards": {},
"config": {
"points": {
"from": 151,
"to": 250
}
},
"points": {
"from": 151,
"to": 250
},
"object": "loyalty_tier"
},
"loyalty_tier_to": {
"id": "ltr_0e30613ad01f044516",
"name": "Loyal gold",
"campaign_id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
"metadata": {},
"created_at": "2024-01-24T08:28:02.240Z",
"updated_at": null,
"earning_rules": {},
"rewards": {},
"config": {
"points": {
"from": 251,
"to": 350
}
},
"points": {
"from": 251,
"to": 350
},
"object": "loyalty_tier"
},
"created_at": "2024-03-11T12:06:34.423Z"
}Loyalty Tier Upgraded
WEBHOOK
EVENTS.CUSTOMER.LOYALTY.TIER.UPGRADED
{
"customer": {
"id": "cust_2p0TvCOvB25HWUrW9JFf4czJ",
"name": "Alex Doe",
"email": null,
"source_id": "4l3x-d03",
"metadata": {},
"object": "customer"
},
"campaign": {
"id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
"name": "Loyalty programme",
"campaign_type": "LOYALTY_PROGRAM",
"type": "AUTO_UPDATE",
"is_referral_code": false,
"voucher": {
"type": "LOYALTY_CARD",
"loyalty_card": {
"points": 0
},
"redemption": {
"quantity": null,
"redeemed_quantity": 0
},
"code_config": {
"length": 8,
"prefix": "",
"charset": "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ",
"pattern": "########",
"postfix": ""
}
},
"auto_join": true,
"join_once": true,
"active": true,
"category_id": null,
"category": null,
"metadata": {},
"start_date": null,
"expiration_date": null,
"description": null,
"created_at": "2024-01-18T15:18:38.577Z",
"updated_at": "2024-02-09T13:04:15.034Z",
"object": "campaign"
},
"loyalty_tier_from": {
"id": "ltr_0e30613ad01f044515",
"name": "Loyal silver",
"campaign_id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
"metadata": {},
"created_at": "2024-01-24T08:28:02.240Z",
"updated_at": null,
"earning_rules": {},
"rewards": {},
"config": {
"points": {
"from": 151,
"to": 250
}
},
"points": {
"from": 151,
"to": 250
},
"object": "loyalty_tier"
},
"loyalty_tier_to": {
"id": "ltr_0e30613ad01f044516",
"name": "Loyal gold",
"campaign_id": "camp_AQZ1GLRlbGaC2dETd31VbJQ9",
"metadata": {},
"created_at": "2024-01-24T08:28:02.240Z",
"updated_at": null,
"earning_rules": {},
"rewards": {},
"config": {
"points": {
"from": 251,
"to": 350
}
},
"points": {
"from": 251,
"to": 350
},
"object": "loyalty_tier"
},
"created_at": "2024-03-11T12:06:34.423Z"
}Legacy loyaltyThis event applies to legacy loyalty only (loyalty campaigns and loyalty cards). It is not emitted for loyalty programs in the Loyalty hub.For Loyalty hub member activity and transactions, use Workflows. See Workflows webhooks.
EVENTS.CUSTOMER.LOYALTY.TIER.UPGRADED event indicates that a customer has moved to a higher tier or a specific tier in a legacy loyalty campaign.
This event is used in a webhook configured in Distributions in Voucherify dashboard.
This page documents only the event. If you need more details about the webhook payload data that includes this event, go to Introduction to webhooks page.
Body
application/json
Event data object schema for customer.loyalty.tier.upgraded.
Simplified customer data.
Show child attributes
Show child attributes
Simplified campaign data.
Show child attributes
Show child attributes
Loyalty tier within a legacy loyalty campaign.
Show child attributes
Show child attributes
Loyalty tier within a legacy loyalty campaign.
Show child attributes
Show child attributes
Timestamp representing the date and time when the customer entered a higher loyalty tier.
Example:
"2022-02-25T13:32:08.734Z"
Response
Webhook accepted
Last modified on November 5, 2026

