Event-Driven Extensibility
Webhooks
Pushes HTTP notifications to external systems when something happens in FerrisKey: a user created, a role assigned, a secret rotated. It bridges the identity layer to the rest of your stack.
Covers
HTTP POSTEvent SubscriptionsCustom HeadersAuth HeaderReal-Time SyncCRM IntegrationSlack NotificationsPagerDutySIEM ForwardingLifecycle EventsKey capabilities
What Webhooks does for you.
- 01
Event Subscriptions
Subscribe each webhook to the events it cares about: user.created, user.role.assigned, client.deleted, and 35 more.
- 02
Custom Headers
Add Authorization, X-Webhook-Secret, or any custom header to authenticate deliveries at the receiving end.
- 03
Per-Realm Scope
Webhooks are scoped to a realm. Each tenant can have its own set of endpoints and subscriptions.
- 04
Multiple Endpoints
Register as many webhooks as needed. The same event fans out to all registered subscribers in parallel.
- 05
Last Triggered At
Each webhook records when it last fired, which is what you want when debugging a silent integration.
- 06
Decoupled Design
Your app reacts to identity events without polling FerrisKey. Clean event-driven integration.
How it works
From the first request to the result, in 4 steps.
- 1
Register webhook
Create a webhook with a target URL, optional custom headers, and a name. Scoped to a realm.
- 2
Subscribe to events
Add event subscriptions, choosing which lifecycle events should trigger the webhook.
- 3
Event fires
A matching event occurs in the realm. FerrisKey builds the payload and dispatches an HTTP POST.
- 4
Your system responds
Your endpoint receives the structured payload and reacts: send an email, sync a CRM, trigger a workflow.
Ready to use Webhooks?
Full reference, configuration options, and examples in the documentation.