points.earned

{
  "event": "points.earned",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "points_earned": 150,
    "points_balance": 700,
    "lifetime_points": 1200,
    "source": "earning_rule",
    "earning_rule_name": "Purchase reward",
    "order_number": "1042"
  }
}

{
  "event": "points.earned",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "points_earned": 150,
    "points_balance": 700,
    "lifetime_points": 1200,
    "source": "earning_rule",
    "earning_rule_name": "Purchase reward",
    "order_number": "1042",
    "loyalty_mode": "store_credit",
    "currency": "GBP",
    "credit_earned": "1.50",
    "credit_balance": "7.00"
  }
}

Fired when a customer earns points. This covers all sources: order-based earning rules, custom earning rules, manual adjustments, and referral bonuses.

Payload fields

Field	Type	Description
`shopify_customer_id`	string	The customer’s Shopify customer ID
`email`	string \| null	The customer’s email address
`points_earned`	integer	Number of points earned in this event
`points_balance`	integer	The customer’s total available points after this event
`lifetime_points`	integer	The customer’s all-time total earned points
`source`	string	How the points were earned. One of `order`, `earning_rule`, `manual`, `referral`, or `approval_cron` (points released after an approval delay)
`earning_rule_name`	string \| null	Name of the earning rule, if applicable
`order_number`	string \| null	Shopify order number, if the points were earned from a purchase

Store-credit shops

On store-credit shops, the point values above are minor currency units, and data carries three extra fields: loyalty_mode (store_credit), currency, and major-unit decimal-string companions credit_earned and credit_balance. Points-mode payloads do not include these fields. See Loyalty modes.

Example payload

{
  "event": "points.earned",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "points_earned": 150,
    "points_balance": 700,
    "lifetime_points": 1200,
    "source": "earning_rule",
    "earning_rule_name": "Purchase reward",
    "order_number": "1042"
  }
}

{
  "event": "points.earned",
  "shop": "my-store",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "data": {
    "shopify_customer_id": "6789012345",
    "email": "jane@example.com",
    "points_earned": 150,
    "points_balance": 700,
    "lifetime_points": 1200,
    "source": "earning_rule",
    "earning_rule_name": "Purchase reward",
    "order_number": "1042",
    "loyalty_mode": "store_credit",
    "currency": "GBP",
    "credit_earned": "1.50",
    "credit_balance": "7.00"
  }
}

Common use cases

Sync points to an external CRM or data warehouse
Trigger a personalised email or SMS when a customer hits a milestone (e.g. 1000 lifetime points)
Display a real-time notification on your storefront
Update a customer profile in your CRM or marketing platform

Verifying Webhook Signatures points.redeemed

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