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

# Webhooks API

> Register HTTPS callbacks for room events.

```http theme={null}
GET    /admin/webhooks
POST   /admin/webhooks
DELETE /admin/webhooks/:webhookId
```

Create body:

```json theme={null}
{
  "url": "https://example.com/hooks/roomd"
}
```

On new events, roomd POSTs JSON with:

```http theme={null}
X-Roomd-Signature: <hmac-sha256 hex of body>
```

Check the signature with the webhook secret before acting.

UI: [Webhooks](/guides/webhooks-ui).