> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baselayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Federation-Level Webhook Endpoints

> Mar 17, 2026

Federation partners can now register a single webhook endpoint at the Federation level, receiving events across all organizations and environments under their Federation.

Previously, webhook endpoints could only be registered per Organization - requiring partners to manage a separate endpoint and signing secret for each customer. The new Federation-level endpoint eliminates this overhead: one endpoint, one signing secret, all events.

Each event payload includes an enriched `__event__` envelope with `external_id`, `organization_id`, `application_id`, and `application_type` fields so you can route events to the correct customer in your system.

To pre-filter delivery before events reach your endpoint, you can configure `channels` at creation time. Available filters include `production`, `sandbox`, `Organization.<organization_id>`, and `Application.<application_id>`. Filters can be combined.

Federation webhook endpoints can be created via the console under **My Federation > Webhooks & Logs**, or programmatically via `POST /webhooks` using your Federation API key.

For full implementation details, see the [Organization Management guide](https://docs.baselayer.com/docs/federations-at-baselayer.md#federation-webhooks).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.