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

# Webhooks

> Send signed HTTP requests when content changes.

Every command also takes the [global options](https://docs.nohead.io/cli/commands/global-options.md), such as `--json`.

## `nohead webhooks list`

List the project's webhooks.

```bash theme={null}
nohead webhooks list [options]
```

| Option | |
| - | - |
| `--limit <n>` | Page size (1-100, default 100) |
| `--cursor <cursor>` | Continue from a previous page's next\_cursor. |
| `--all` | Follow cursors and return every webhook. |

## `nohead webhooks create`

Create a webhook; prints its signing secret (shown only now)

```bash theme={null}
nohead webhooks create [options]
```

| Option | |
| - | - |
| `--url <url>` | Https URL to send events to. |
| `--events <types>` | comma-separated event types, or \* for all. Default: `*`. |
| `--description <text>` | What it is for. |
| `--published-only` | Send only changes to published content: no drafts, schedules or edits to unpublished records. |

## `nohead webhooks delete`

Delete a webhook.

```bash theme={null}
nohead webhooks delete [options] <id>
```

| Argument | |
| - | - |
| `<id>` | Webhook ID (wh\_...) |

## `nohead webhooks rotate-secret`

Add a new signing secret; the old ones keep signing for 24 hours.

```bash theme={null}
nohead webhooks rotate-secret [options] <id>
```

| Argument | |
| - | - |
| `<id>` | Webhook ID (wh\_...) |

## `nohead webhooks test`

Send a webhook.test event.

```bash theme={null}
nohead webhooks test [options] <id>
```

| Argument | |
| - | - |
| `<id>` | Webhook ID (wh\_...) |

## `nohead webhooks deliveries`

List a webhook's deliveries, newest first.

```bash theme={null}
nohead webhooks deliveries [options] <id>
```

| Argument | |
| - | - |
| `<id>` | Webhook ID (wh\_...) |

| Option | |
| - | - |
| `--status <status>` | Only deliveries with this status. One of `pending`, `succeeded`, `failed`. |
| `--limit <n>` | Page size (1-100, default 100) |
| `--cursor <cursor>` | Continue from a previous page's next\_cursor. |
| `--all` | Follow cursors and return every delivery. |

## `nohead webhooks delivery`

Show a delivery with its attempts.

```bash theme={null}
nohead webhooks delivery [options] <delivery>
```

| Argument | |
| - | - |
| `<delivery>` | Delivery ID (whd\_...) |

## `nohead webhooks retry`

Attempt a delivery again now.

```bash theme={null}
nohead webhooks retry [options] <delivery>
```

| Argument | |
| - | - |
| `<delivery>` | Delivery ID (whd\_...) |


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