Create a webhook
Add an endpoint. Its signing secret is in this response only.
Headers
- Idempotency-Keystringoptional
Optional, up to 255 visible characters (a UUID). A retry with the same key and body within 24 hours makes nothing new; see Idempotent retries.
Body
application/json- urlstringrequired
A public HTTPS URL, up to 500 characters.
- eventsstring[]optional
budget.threshold,balance.low,spend.anomaly,end_user.budget_exhausted,key.created,key.revoked,key.paused,key.compromised,topup.succeeded,topup.failed,autoreload.paused,auditor.review.completed. Empty or left out: every event, including types added later. - projectstring | nulloptional
A project's id or slug: the endpoint gets only that project's events (its budgets, keys and end users), none of the team's own. Null or left out: every event of the team.
Notes
- secretoptional
Verify each delivery's signature with it; see Alerts and webhooks.
- Limitoptional
Up to 5 endpoints per team.