---
updatedAt: 2026-10-29T15:41:23.000Z
agentTools:
  projectIndex: https://docs.yotpo.com/llms.txt
---

# Tier Expiration Reminder

Sent when a customer is at risk of losing their tier: 30, 14 and 7 days before it expires, depending on your settings, and only if they haven't met the requirements to keep it. Each reminder is sent once.

To receive it, add `yotpo/tier/expiration/reminder` to `events` when you [create a filter](ref:create-filter), then [subscribe](ref:create-subscription) the filter to your target. Yotpo sends the event to your target URL as a `POST` with this JSON body.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Yotpo Webhooks",
    "description": "Events Yotpo sends to your webhook URL. Each event is an HTTP POST with a JSON body. To receive them, create a webhook target, a filter and a subscription.",
    "version": "3.0"
  },
  "webhooks": {
    "yotpo/tier/expiration/reminder": {
      "post": {
        "operationId": "yotpo-tier-expiration-reminder",
        "summary": "Tier Expiration Reminder",
        "description": "Sent when a customer is at risk of losing their tier: 30, 14 and 7 days before it expires, depending on your settings, and only if they haven't met the requirements to keep it. Each reminder is sent once.\n\nTo receive it, add `yotpo/tier/expiration/reminder` to `events` when you [create a filter](ref:create-filter), then [subscribe](ref:create-subscription) the filter to your target. Yotpo sends the event to your target URL as a `POST` with this JSON body.",
        "security": [],
        "parameters": [
          {
            "name": "X-Yotpo-Webhooks-Event-Type",
            "in": "header",
            "required": true,
            "description": "The event name. Matches `topic` in the body.",
            "schema": {
              "type": "string"
            },
            "example": "yotpo/tier/expiration/reminder"
          },
          {
            "$ref": "#/components/parameters/WebhookTenantType"
          },
          {
            "$ref": "#/components/parameters/WebhookTenantId"
          },
          {
            "$ref": "#/components/parameters/WebhookMessageId"
          },
          {
            "$ref": "#/components/parameters/WebhookMessageIdPerTarget"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "topic": {
                    "description": "The event name, `yotpo/tier/expiration/reminder`.",
                    "type": "string"
                  },
                  "name": {
                    "description": "The display name of the event.",
                    "type": "string"
                  },
                  "website_url": {
                    "description": "Your store's website URL.",
                    "type": "string"
                  },
                  "store_name": {
                    "description": "Your store's name.",
                    "type": "string"
                  },
                  "email": {
                    "description": "The email address of the customer whose tier is about to expire.",
                    "type": "string"
                  },
                  "customer": {
                    "type": "object",
                    "properties": {
                      "total_spend_cents": {
                        "description": "Total spend recorded for the customer, in cents.",
                        "type": "integer"
                      },
                      "total_purchases": {
                        "description": "Number of purchases recorded for the customer.",
                        "type": "integer"
                      },
                      "perks_redeemed": {
                        "description": "Number of rewards the customer has redeemed.",
                        "type": "integer"
                      },
                      "last_purchase_at": {
                        "description": "When the customer's last recorded purchase was made, or `null`.",
                        "type": [
                          "string",
                          "null"
                        ],
                        "format": "date-time"
                      },
                      "first_name": {
                        "description": "The customer's first name.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "last_name": {
                        "description": "The customer's last name.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "is_member": {
                        "description": "Whether the customer is a loyalty program member.",
                        "type": "boolean"
                      },
                      "accepts_marketing": {
                        "description": "Whether the customer accepts marketing, or `null` when unknown.",
                        "type": [
                          "boolean",
                          "null"
                        ]
                      },
                      "email": {
                        "description": "The customer's email address.",
                        "type": "string"
                      },
                      "points_balance": {
                        "description": "The points the customer can spend now, after this event.",
                        "type": "integer"
                      },
                      "points_earned": {
                        "description": "Total points the customer has earned over their lifetime.",
                        "type": "integer"
                      },
                      "last_seen_at": {
                        "description": "When Yotpo Loyalty last recorded activity for the customer, or `null`.",
                        "type": [
                          "string",
                          "null"
                        ],
                        "format": "date-time"
                      },
                      "thirty_party_id": {
                        "description": "Legacy misspelled duplicate of `third_party_id`. Use `third_party_id`.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "third_party_id": {
                        "description": "The customer's ID in your e-commerce platform.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "referral_link": {
                        "description": "The customer's personal referral link.",
                        "type": "string"
                      },
                      "referral_discount_code": {
                        "description": "The discount code the customer received for being referred, or `null`.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "is_opt_in": {
                        "description": "Whether the customer is opted in to the loyalty program.",
                        "type": "boolean"
                      },
                      "loyalty_opt_in_date": {
                        "description": "The date the customer opted in to the loyalty program, or `null` when they have not.",
                        "type": "string"
                      },
                      "has_store_account": {
                        "description": "Whether the customer has an account in your store.",
                        "type": "boolean"
                      },
                      "credit_balance": {
                        "description": "Store-credit value of the points balance, formatted in your store currency, for example `$0`.",
                        "type": "string"
                      },
                      "credit_balance_in_customer_currency": {
                        "description": "Store-credit value of the points balance, formatted in the customer's currency.",
                        "type": "string"
                      },
                      "is_affiliate": {
                        "description": "Whether the customer is an affiliate.",
                        "type": "boolean"
                      },
                      "points_expire_at": {
                        "description": "When the customer's points expire, or `null` when they never expire. Follows your **Points expiration policy**: **Last Activity** (counted from the customer's last activity), **Date Earned** (the next upcoming expiration across the customer's point batches) or **Never expire** (`null`).",
                        "type": [
                          "string",
                          "null"
                        ],
                        "format": "date-time"
                      },
                      "referred_by_customer": {
                        "description": "The email address of the customer who referred this customer, or `null` when there is no referrer.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "vip_tier_name": {
                        "description": "The customer's current VIP tier, or `null` when they aren't in one.",
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "vip_tier_ends_at": {
                        "description": "When the customer's current VIP tier ends, or `null` when it doesn't expire.",
                        "type": [
                          "string",
                          "null"
                        ],
                        "format": "date"
                      },
                      "anniversary_month": {
                        "description": "The customer's anniversary month (1 to 12), or `null` when not set.",
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "anniversary_day": {
                        "description": "The day of the month of the customer's anniversary, or `null` when not set.",
                        "type": [
                          "integer",
                          "null"
                        ]
                      },
                      "anniversary_year": {
                        "description": "The year of the customer's anniversary, or `null` when not set.",
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "description": "The customer object, including current VIP tier details (`vip_tier_name`, `vip_tier_ends_at`)."
                  },
                  "vip_tier_expiration_date": {
                    "description": "The date and time when the customer's current VIP tier expires (ISO 8601).",
                    "type": "string",
                    "format": "date-time"
                  },
                  "vip_tier_expiration_reminder_days": {
                    "description": "How many days remain before the tier expires (for example, `30`, `14`, or `7`).",
                    "type": "integer"
                  },
                  "vip_stats": {
                    "type": "object",
                    "properties": {
                      "points_earned": {
                        "description": "Points earned in the current tier period.",
                        "type": "integer"
                      },
                      "amount_spent_cents": {
                        "description": "Spend in the current tier period, in cents.",
                        "type": "integer"
                      }
                    },
                    "description": "The customer's current progress toward tier requirements (`points_earned`, `amount_spent_cents`)."
                  },
                  "vip_stats_needed_maintain": {
                    "type": "object",
                    "properties": {
                      "points_needed": {
                        "description": "Points still needed to keep the current tier.",
                        "type": "integer"
                      },
                      "amount_cents_needed": {
                        "description": "Spend still needed to keep the current tier, in cents.",
                        "type": "integer"
                      }
                    },
                    "description": "How much more the customer needs to maintain their current tier (`points_needed`, `amount_cents_needed`)."
                  },
                  "next_vip_tier_name": {
                    "description": "The name of the next VIP tier above the customer's current tier.",
                    "type": "string"
                  },
                  "vip_stats_needed_next": {
                    "type": "object",
                    "properties": {
                      "points_needed": {
                        "description": "Points still needed to reach the next tier.",
                        "type": "integer"
                      },
                      "amount_cents_needed": {
                        "description": "Spend still needed to reach the next tier, in cents.",
                        "type": "integer"
                      }
                    },
                    "description": "How much more the customer needs to reach the next tier. This object is optional and may be omitted from the payload."
                  },
                  "published_at": {
                    "description": "When Yotpo sent the event.",
                    "type": "string",
                    "format": "date-time"
                  }
                }
              },
              "example": {
                "topic": "yotpo/tier/expiration/reminder",
                "name": "Yotpo Tier Expiration Reminder",
                "website_url": "http://yotpo.myshopify.com",
                "store_name": "Yotpo",
                "email": "name@example.com",
                "customer": {
                  "total_spend_cents": 0,
                  "total_purchases": 0,
                  "perks_redeemed": 14,
                  "last_purchase_at": null,
                  "first_name": "John",
                  "last_name": "Smith",
                  "is_member": true,
                  "accepts_marketing": false,
                  "email": "name@example.com",
                  "points_balance": 0,
                  "points_earned": 0,
                  "last_seen_at": null,
                  "thirty_party_id": "4302977345",
                  "third_party_id": "4302977345",
                  "referral_link": "http://rwrd.io/x09u052",
                  "referral_discount_code": null,
                  "is_opt_in": true,
                  "loyalty_opt_in_date": "2024-07-31",
                  "has_store_account": true,
                  "credit_balance": "$0",
                  "credit_balance_in_customer_currency": "$0",
                  "is_affiliate": false,
                  "points_expire_at": null,
                  "referred_by_customer": null,
                  "vip_tier_name": "Silver",
                  "vip_tier_ends_at": "2027-04-08",
                  "anniversary_month": 1,
                  "anniversary_day": 1,
                  "anniversary_year": ""
                },
                "vip_tier_expiration_date": "2027-04-08T07:07:00.000Z",
                "vip_tier_expiration_reminder_days": 7,
                "vip_stats": {
                  "points_earned": 0,
                  "amount_spent_cents": 0
                },
                "vip_stats_needed_maintain": {
                  "points_needed": 250,
                  "amount_cents_needed": 0
                },
                "next_vip_tier_name": "Gold",
                "vip_stats_needed_next": {
                  "points_needed": 500,
                  "amount_cents_needed": 0
                },
                "published_at": "2024-08-08T07:38:37.748+00:00"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return any 2xx status quickly to acknowledge the event. Without one, Yotpo retries at least 10 times with exponential backoff."
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "WebhookMessageId": {
        "name": "WebhookMessageId",
        "in": "header",
        "required": true,
        "description": "A unique ID for the event.",
        "schema": {
          "type": "string"
        },
        "example": "2f1c7a8e-5b1d-4c39-9a0e-3d7f2b6c1e44"
      },
      "WebhookMessageIdPerTarget": {
        "name": "WebhookMessageIdPerTarget",
        "in": "header",
        "required": true,
        "description": "A unique ID for this delivery to this target. Use it to ignore duplicates.",
        "schema": {
          "type": "string"
        },
        "example": "066c9f28-3e87-45d5-a67e-879d6090d989"
      },
      "WebhookTenantId": {
        "name": "X-Yotpo-Webhooks-Tenant-Id",
        "in": "header",
        "required": true,
        "description": "Your store ID.",
        "schema": {
          "type": "string"
        },
        "example": "YOUR_STORE_ID"
      },
      "WebhookTenantType": {
        "name": "X-Yotpo-Webhooks-Tenant-Type",
        "in": "header",
        "required": true,
        "description": "The kind of account the event belongs to.",
        "schema": {
          "type": "string"
        },
        "example": "store"
      }
    }
  }
}
```

# Sibling pages

* [Coupon Earned](https://docs.yotpo.com/reference/swell-redemption-created.md)
* [Custom Reward Redeemed](https://docs.yotpo.com/reference/loyalty-custom-reward-created.md)
* [Customer Birthday](https://docs.yotpo.com/reference/swell-customer-birthday.md)
* [Customer Birthday Captured](https://docs.yotpo.com/reference/swell-birthday-captured.md)
* [Customer Anniversary](https://docs.yotpo.com/reference/swell-customer-anniversary.md)
* [Customer Anniversary Captured](https://docs.yotpo.com/reference/swell-anniversary-captured.md)
* [Donation Created](https://docs.yotpo.com/reference/loyalty-donation-created.md)
* [Account Created](https://docs.yotpo.com/reference/swell-account-created.md)
* [Loyalty Opt In](https://docs.yotpo.com/reference/loyalty-opt-in.md)
* [Loyalty Opt Out](https://docs.yotpo.com/reference/loyalty-opt-out.md)
* [Points Changed](https://docs.yotpo.com/reference/swell-points-changed.md)
* [Points Earned](https://docs.yotpo.com/reference/swell-points-earned.md)
* [Points Reminder](https://docs.yotpo.com/reference/swell-points-reminder.md)
* [Points Expiration Reminder](https://docs.yotpo.com/reference/loyalty-expiration-reminder.md)
* [Redemption Below Threshold](https://docs.yotpo.com/reference/swell-redemption-code-below-threshold.md)
* [Redemption Cancellation Request](https://docs.yotpo.com/reference/swell-point-redemption-cancellation-request.md)
* [Redemption Reminder](https://docs.yotpo.com/reference/swell-redemption-reminder.md)
* [Referral Link Share](https://docs.yotpo.com/reference/swell-referral-share.md)
* [Referral Link Share (2.0)](https://docs.yotpo.com/reference/yotpo-referral-shared.md)
* [Referral Share Reminder](https://docs.yotpo.com/reference/swell-referral-share-reminder.md)
* [Referral Product Share Link](https://docs.yotpo.com/reference/loyalty-referral-product-share.md)
* [Referral Product Share Reminder](https://docs.yotpo.com/reference/loyalty-referral-product-share-reminder.md)
* [Referral Completed](https://docs.yotpo.com/reference/swell-referral-completed.md)
* [Referral Completed (2.0)](https://docs.yotpo.com/reference/yotpo-referral-completed.md)
* [Tier Earned](https://docs.yotpo.com/reference/swell-tier-earned.md)
* [Tier Lost](https://docs.yotpo.com/reference/swell-tier-lost.md)
* [Tier Status Changed](https://docs.yotpo.com/reference/swell-tier-status-changed.md)
* [CommerceCloud Integration Disabled](https://docs.yotpo.com/reference/loyalty-integrations-integration-disabled.md)