YOyotpo

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, then create a store subscription for each store that installed your app. Yotpo sends the event to your target URL as a POST with this JSON body.

postWebhookyotpo/tier/expiration/reminder

Headers

X-Yotpo-Webhooks-Event-Typestring required

The event name. Matches topic in the body.

X-Yotpo-Webhooks-Tenant-Typestring required

The kind of account the event belongs to: store for store events.

X-Yotpo-Webhooks-Tenant-Idstring required

The store ID (app_key) the event belongs to.

WebhookMessageIdstring required

A unique ID for the event.

WebhookMessageIdPerTargetstring required

A unique ID for this delivery to this target. Use it to ignore duplicates.

Payload

topicstring

The event name, yotpo/tier/expiration/reminder.

namestring

The display name of the event.

website_urlstring

Your store's website URL.

store_namestring

Your store's name.

emailstring

The email address of the customer whose tier is about to expire.

vip_tier_expiration_datestring date-time

The date and time when the customer's current VIP tier expires (ISO 8601).

vip_tier_expiration_reminder_daysinteger

How many days remain before the tier expires (for example, 30, 14, or 7).

next_vip_tier_namestring

The name of the next VIP tier above the customer's current tier.

published_atstring date-time

When Yotpo sent the event.

Response

Return any 2xx status quickly to acknowledge the event. Without one, Yotpo retries at least 10 times with exponential backoff.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.