customer.tier_upgrade

{
  "event": "customer.tier_upgrade",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "previous_tier": "Silver",
    "new_tier": "Gold",
    "lifetime_points": 1200
  }
}

{
  "event": "customer.tier_upgrade",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "previous_tier": "Silver",
    "new_tier": "Gold",
    "lifetime_points": 1200,
    "loyalty_mode": "store_credit",
    "currency": "GBP",
    "lifetime_credit": "12.00"
  }
}

{
  "event": "customer.tier_upgrade",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "previous_tier": "None",
    "new_tier": "Silver",
    "lifetime_points": 500
  }
}

Fired when a customer accumulates enough lifetime points to move up to a higher VIP tier. The event includes both the previous and new tier names so you can tailor your response.

Payload fields

Field	Type	Description
`shopify_customer_id`	string	The customer’s Shopify customer ID
`email`	string \| null	The customer’s email address
`previous_tier`	string	The tier the customer was on before the upgrade. Always a string: a tier name, or the literal string `"None"` if the customer had no prior tier (never `null`)
`new_tier`	string	The tier the customer has been promoted to
`lifetime_points`	integer	The customer’s all-time total earned points

Store-credit shops

On store-credit shops, lifetime_points is a minor currency unit amount, and data carries loyalty_mode (store_credit), currency, and a major-unit decimal-string companion lifetime_credit. Points-mode payloads do not include these fields. See Loyalty modes.

Example payload

{
  "event": "customer.tier_upgrade",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "previous_tier": "Silver",
    "new_tier": "Gold",
    "lifetime_points": 1200
  }
}

{
  "event": "customer.tier_upgrade",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "previous_tier": "Silver",
    "new_tier": "Gold",
    "lifetime_points": 1200,
    "loyalty_mode": "store_credit",
    "currency": "GBP",
    "lifetime_credit": "12.00"
  }
}

{
  "event": "customer.tier_upgrade",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "previous_tier": "None",
    "new_tier": "Silver",
    "lifetime_points": 500
  }
}

Common use cases

Send a congratulatory email or SMS welcoming the customer to their new tier
Update the customer’s segment or tag in your marketing platform
Trigger a special one-time reward or gift for reaching the new tier
Log tier progression data for analytics and reporting

points.redeemed customer.tier_downgrade

REST API

API Resources

Webhook Events

Shopify Metafields

Payload fields

Store-credit shops

Example payload

Common use cases

​Payload fields

​Store-credit shops

​Example payload

​Common use cases

Payload fields

Store-credit shops

Example payload

Common use cases