subscription.expired
endsat reached; access revoked.
When this fires
The subscription's ends_at has passed. Resource access is revoked and the subscription transitions to its terminal state.
Caveats
- Pairs with
member.churnedwhen this is the subscriber's last active subscription. - Resource access is revoked as part of expiry; expect
member.resource_removedevents for each granted resource.
Related events
subscription.cancelled,subscription.unpaid,subscription.trial_expired: predecessors.member.churned: paired member-level event.
Header Parameters
t=<unix seconds>,v1=<hex>: the HMAC-SHA256 of "<t>.<raw body>" under the endpoint's secret. Verify it before acting, and refuse a t more than 300 seconds from now. During a secret rotation a v0= signature under the previous secret may precede v1=.
The event's ULID, bare. The envelope's id is the same ULID prefixed evt_, so strip the prefix before comparing. Deduplicate on it: a retry carries the same id.
The event name, the same as the envelope's type.
Always application/json.
Always Subscriby-Webhooks/1.0.
Request Body
application/json
The signed JSON envelope posted to your endpoint.
TypeScript Definitions
Use the request body type in TypeScript.
The envelope every event is delivered in.
Response Body
Example Requests
/subscription.expiredHow is this guide?