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

# Webhooks

> Send incident events from Still200 to your systems.

Webhooks let Still200 notify your application when an incident starts or resolves. Use them to trigger internal automation, update an external status system, or forward incidents to another alerting platform.

```mermaid theme={null}
sequenceDiagram
    participant Still200
    participant Endpoint as Your endpoint
    Still200->>Endpoint: POST signed event
    alt Delivery succeeds
        Endpoint-->>Still200: 2xx
    else Delivery fails
        Endpoint-->>Still200: non-2xx, or no response (timeout)
        Note over Still200: Schedule retry with exponential backoff
        Still200->>Endpoint: Retry POST signed event
    end
```

## Create an endpoint

**1. Open Webhooks**

Open **Webhooks** in [Still200](https://app.still200.com/settings/webhooks).

**2. Enter the destination**

Add a publicly reachable HTTPS URL.

**3. Enter a description**

Something to quickly help you remember what this webhook is for.

**4. Select events**

Select events you wish to receive webhooks for.

**5. Store the signing secret**

Copy the generated secret into your application's secret store. Signing secrets begin with `s200_whsec_` and are shown when the endpoint is created or rotated.

**6. Send a test event**

Send a test delivery, verify its signature, and confirm your endpoint returns a `2xx` response.

> [!WARNING]
>
> Do not log or expose the signing secret. Rotating it invalidates the previous secret for new deliveries.

## Requirements

Your destination must:

* Use HTTPS and be publicly reachable.
* Accept `POST` requests containing JSON.
* Return a `2xx` response within ten seconds.
* Verify the request signature before processing the payload.
* Handle duplicate events safely by using the event `id` as an idempotency key.

> [card] [Event payloads](https://docs.still200.com/webhooks/events.md)

> [card] [Verify signatures](https://docs.still200.com/webhooks/signatures.md)


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