Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.mageloyalty.com/llms.txt

Use this file to discover all available pages before exploring further.

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

FieldTypeDescription
shopify_customer_idstringThe customer’s Shopify customer ID
emailstring | nullThe customer’s email address
previous_tierstring | nullThe tier the customer was on before the upgrade, or null if they had no tier
new_tierstringThe tier the customer has been promoted to
lifetime_pointsintegerThe customer’s all-time total earned points

​
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
  }
}

​
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