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

# webhooks

> DevHelm CLI webhooks commands — list, get, create, update, delete, and test platform webhooks

Manage platform webhooks from the command line. Platform webhooks push events from DevHelm to your HTTP endpoints — distinct from [alert channel webhooks](/integrations/webhooks) used for incident notifications.

## Commands

| Command                        | Description         |
| ------------------------------ | ------------------- |
| `devhelm webhooks list`        | List all webhooks   |
| `devhelm webhooks get <id>`    | Get webhook details |
| `devhelm webhooks create`      | Create a webhook    |
| `devhelm webhooks update <id>` | Update a webhook    |
| `devhelm webhooks delete <id>` | Delete a webhook    |
| `devhelm webhooks test <id>`   | Send a test event   |

## webhooks list

```bash theme={null}
devhelm webhooks list
```

## webhooks get

Webhook IDs are UUIDs — get them from `devhelm webhooks list`.

```bash theme={null}
devhelm webhooks get <webhook-id> -o json
```

## webhooks create

```bash theme={null}
devhelm webhooks create \
  --url https://hooks.example.com/devhelm \
  --events monitor.created,incident.created,incident.resolved
```

| Flag            | Type   | Required | Description                                                             |
| --------------- | ------ | -------- | ----------------------------------------------------------------------- |
| `--url`         | string | Yes      | Endpoint URL that receives event payloads (must be a valid HTTP(S) URL) |
| `--events`      | string | Yes      | Comma-separated list of subscribed events                               |
| `--description` | string | —        | Human-readable description                                              |

Valid event types (unknown values are rejected locally with the full list):

`monitor.created`, `monitor.updated`, `monitor.deleted`, `incident.created`, `incident.resolved`, `incident.reopened`, `service.status_changed`, `service.component_changed`, `service.incident_created`, `service.incident_updated`, `service.incident_resolved`

## webhooks update

```bash theme={null}
devhelm webhooks update <webhook-id> \
  --events monitor.created,monitor.deleted,incident.created
```

Supports the same flags as `create`, all optional. `--events` **replaces** the full subscription list — include every event you still want.

## webhooks delete

Prompts for confirmation; pass `--yes` (`-y`) in scripts and CI.

```bash theme={null}
devhelm webhooks delete <webhook-id>
```

## webhooks test

Send a test event to verify the endpoint is reachable and responding correctly.

```bash theme={null}
devhelm webhooks test <webhook-id>
```

## Next steps

<CardGroup cols={2}>
  <Card title="Webhook integration" icon="webhook" href="/integrations/webhooks">
    Payload format, HMAC signing, and event types.
  </Card>

  <Card title="Alert channels" icon="bell" href="/cli/commands/alert-channels">
    Manage alert channel webhooks for incident notifications.
  </Card>
</CardGroup>