# Create a webhook

`POST /v1/webhooks`

**In this build:** Real.

**Scope:** `webhook.write`

**CLI:** `harebox webhook new`

Send an `Idempotency-Key` header. A retry with the same key never repeats the action.

## Request: `CreateWebhookRequest`

| Field | Type | Notes |
|---|---|---|
| `name` | `string` |  |
| `url` (required) | `string` |  |
| `events` (required) | `array` | Event types or globs, such as sandbox.* or prompt.finished. |
| `project` | `string or null` |  |
| `label_selector` | `string or null` |  |

## Response: 201

`WebhookWithSecret`

`WebhookWithSecret`

Errors follow [one format](../errors.html).