Loyalty Tier Joined


The EVENTS.CUSTOMER.LOYALTY.TIER.JOINED event indicates that a customer has entered a loyalty campaign tier structure or a specific tier.


Webhook documentation

This page documents only the event. If you need more details about the webhook payload data that includes this event, go to Webhook v2024-01-01 page.

Example: customer.loyalty.tier.joined

  "customer": {
    "id": "cust_154FDQKcbzygdo231M62r4CD",
    "name": "Alex Doe",
    "email": null,
    "source_id": "4lx-d03",
    "metadata": {
      "region": "EMEA"
    "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": {
    "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"
  "created_at": "2024-03-14T09:29:32.501Z"
Click Try It! to start a request and see the response here!