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

# Webhook subscriptions move to the portal

> Webhook subscriptions are now created and managed in the Dolfin portal, and the subscription endpoints no longer accept API keys.

<Update label="2026-07-14" tags={["Change","Breaking"]} description="Portal-managed webhook subscriptions">
  ## Breaking

  ### Webhook subscriptions are managed in the portal

  Webhook subscriptions — the endpoint URL, the events you receive, and the signing secret — are now created and managed in the [Dolfin portal](https://portal.dolfinai.co) under **Webhooks**, rather than through the API.

  The `/v1/webhook-subscriptions` endpoints no longer accept an `x-dolfin-api-key`. If your backend created, updated, or rotated subscriptions programmatically, those calls now return `403 Forbidden` — move that setup into the portal. The portal also lists recent deliveries with their status, response code, and payload, and lets you replay a failed one.

  **Delivery itself is unchanged.** Existing subscriptions keep receiving events, signing secrets still work, and the event payloads, the `Dolfin-Signature` header, and the retry schedule are all the same. Only the management of subscriptions moved.

  See the [webhooks guide](/guides/webhooks) for the current setup flow.
</Update>