# Send alerts to a webhook (https://logable.app/docs/guides/alerts/send-alerts-to-a-webhook)

Register an HTTPS endpoint, copy its signing secret once, attach it to a rule, and test it.



A webhook endpoint sends alert events to a system you run. Logable has one endpoint type: a plain HTTPS URL that your own system receives and handles.

## Register an endpoint [#register-an-endpoint]

1. Open the **Organization** page and select the **Webhooks** tab. This tab is visible to admins and owners.
2. Select **Add endpoint**.
3. Fill in the **Name**, the **URL** (must be HTTPS), an optional **Description**, and any **Custom headers** your receiver needs.
4. Save. Logable shows **Your webhook signing secret** once. Copy it now. You use it to verify that a delivery really came from Logable.
5. Select **Send test event** to check your receiver is ready.

<Figure src="/docs/captures/webhook-add-endpoint.webp" alt="The Add endpoint dialog with a name and URL filled in, before saving" width="1024" height="1500" sizes="(min-width: 1280px) 860px, (min-width: 640px) 90vw, 100vw" caption="Filling in the Add endpoint dialog, before saving." />

## Attach it to a rule [#attach-it-to-a-rule]

Open a rule and, under **Webhook endpoints**, tick the endpoint you want to receive that rule's alerts. A rule can send to more than one endpoint.

## Watch deliveries [#watch-deliveries]

Open an endpoint's delivery log to see every delivery and its status: delivered, sent, queued, skipped, or failed. Select **Replay** to send a failed delivery again. A replay arrives with a new webhook id, so your receiver does not treat it as a duplicate. Logable keeps payload and response detail for 30 days.

## When it switches off [#when-it-switches-off]

An endpoint's status chip shows Active, Failing, Off, or Disabled. Failing means recent deliveries are failing and Logable will turn the endpoint off if it keeps failing. Logable turns an endpoint off automatically for one of two reasons: deliveries kept failing, or the URL resolved to a private address.

## Build the receiver [#build-the-receiver]

See [Receive alerts as an HTTP call](/docs/integrate/webhooks-out) for the payload shape, the signature header, and how to verify it.

## Next steps [#next-steps]

* [Get alerted before a limit is crossed](/docs/guides/alerts/get-alerted-before-a-limit-is-crossed)
* [Receive alerts as an HTTP call](/docs/integrate/webhooks-out)
* [Understand roles](/docs/guides/organizations/understand-roles)