billing.account_locked
The account hits its past-due lockdown.
When this fires
The creator's account reaches its tier's past-due lockdown: day 30 on a paid tier, day 7 on Free or an unconverted trial. New signups on the project's portal pages are blocked and the dashboard surfaces a lockdown banner.
Caveats
- Lockdown is reversible: a successful payment fires
billing.invoice_paidand the lockdown is cleared automatically. There is no dedicated "account_unlocked" event. - Existing subscribers retain access to project resources during lockdown; only new signups are blocked.
Related events
billing.grace_period_warning: the warning that precedes it, 7 days earlier on a paid tier and 4 on Free or an unconverted trial.billing.invoice_paid: automatic unlock signal.
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
/billing.account_lockedHow is this guide?