customer.joined.paid_tier

Triggered when a customer joins a paid tier in the loyalty program through subscription purchase.

customer.joined.paid_tier

Payload Structure

{
  "payload": {
    "createdAt": "2025-05-30T10:17:56.959Z",
    "tierId": "3a636361",
    "merchantId": "inveterate",
    "detail": {
      "entryType": "SUBSCRIPTION_PURCHASE",
      "tierName": "PAID"
    },
    "updatedAt": "2025-05-30T10:17:56.959Z",
    "customerId": "7733540520067"
  },
  "metadata": {
    "id": "f40a52b943e043a761df4f9e21364ccd",
    "retryCount": 0,
    "shopDomain": "inveterate.myshopify.com",
    "topic": "customer.joined.paid_tier",
    "version": "2025-06",
    "triggerredAt": "2025-05-30T10:17:58.166Z"
  }
}

Payload Fields

payload

• createdAt (string): ISO timestamp when the event was created

• tierId (string): Unique identifier for the paid tier the customer joined

• merchantId (string): Merchant identifier

• customerId (string): Customer identifier

• updatedAt (string): ISO timestamp when the event was last updated

• detail (object): Additional details about the tier entry

  • entryType (string): How the customer joined (e.g., "SUBSCRIPTION_PURCHASE")

  • tierName (string): Name of the paid tier

metadata

• id (string): Unique event identifier

• retryCount (number): Number of retry attempts for this event

• shopDomain (string): Shopify domain of the merchant

• topic (string): Event topic name

• version (string): API version

• triggerredAt (string): ISO timestamp when the event was triggered