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

> ## Agent Instructions
> Flowsign is one word with a lowercase s.
> The REST API base URL is https://my.flowsign.app and every endpoint lives under /api/v1.
> When answering API questions, cite the HTTP method and endpoint path.
> API access needs the Enterprise plan and an API key with the API access permission.

# Webhooks

> Send real-time events to your systems, and monitor delivery health.

**Webhooks** is included in the Enterprise plan; on other plans the page shows an upgrade prompt. Managing endpoints requires the manage webhooks permission, which owners and the Admin role hold; without it the page shows **You don't have access to webhooks**.

<Frame caption="The webhooks settings page: delivery stats above the endpoints table.">
  <img src="https://mintcdn.com/doc-a97e5290/PTzM8Xl3JBDj-Kc9/images/guides/settings/webhooks.png?fit=max&auto=format&n=PTzM8Xl3JBDj-Kc9&q=85&s=61a972807cfe1f7cb002162a979a3a90" alt="Webhooks settings page showing the four stat cards and the endpoints table" width="2880" height="1800" data-path="images/guides/settings/webhooks.png" />
</Frame>

## Stats

Four cards summarise your endpoints: **Active endpoints**, **Failing** (endpoints at or over the failure cutoff), **Total deliveries** (all time, across all endpoints) and **Last delivery**.

## Endpoints

**Add endpoint** creates a new webhook endpoint with an **Endpoint URL**, an optional **Description**, and the **Events** it subscribes to (see [Events](/webhooks/events)). An endpoint hears only the workspace it was added in, and a workspace holds up to 20. Search and a status filter (**All statuses**, **Active**, **Paused**, **Failing**) narrow the table. Per endpoint you can view its deliveries, send a test event, rotate its secret, edit it, pause or resume it, and delete it.

<Frame caption="Adding a webhook endpoint.">
  <img src="https://mintcdn.com/doc-a97e5290/PTzM8Xl3JBDj-Kc9/images/guides/settings/webhooks/add-endpoint-dialog.png?fit=max&auto=format&n=PTzM8Xl3JBDj-Kc9&q=85&s=6a77eeb53b6917db4a5a0dbb5c49fce9" alt="The add endpoint dialog with Endpoint URL, Description and Events fields" width="1400" height="1532" data-path="images/guides/settings/webhooks/add-endpoint-dialog.png" />
</Frame>

<Note>
  A paused or failing endpoint keeps recording events without sending them. **Resume** resets its failure count and sends everything it held, oldest first.
</Note>

**Send test event** picks one of the endpoint's subscribed events, sends a signed sample straight away and shows the result. The delivery appears in the log marked **Test**.

## Deliveries

**View deliveries** opens **Recent deliveries**, listing the endpoint's deliveries newest first, 25 to a page, with a filter by status: **Delivered**, **Retrying** (a retry is scheduled, with the time of the next attempt), **Exhausted** (every attempt failed) or **Pending** (not yet tried, or held while the endpoint is paused or failing). **Retry now** on an exhausted delivery queues it again. Deliveries are kept for 30 days.

## Signing secrets

Every endpoint gets a signing secret when created, used to verify requests really came from Flowsign. It is shown once, at creation, and can't be retrieved again. If a secret is lost or exposed, **Rotate secret** issues a new one, shown once. The old secret keeps working for 24 hours so your receiver can switch over, and the endpoint shows **Rotating until** that time.

## Related

* [Webhooks overview](/webhooks/overview)
* [Events](/webhooks/events)
* [API keys](/guides/settings/api-keys)