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

# webhooks delete

> Delete a webhook by id.

Delete a webhook from the authenticated workspace by id. After deletion, Clay stops sending deliveries to that endpoint.

See the [webhooks overview](/cli/reference/webhooks) for the delivery payload shape and signature verification.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay webhooks delete <webhookId>
```

## Arguments

| Argument    | Description                                                                                           |
| ----------- | ----------------------------------------------------------------------------------------------------- |
| `webhookId` | Webhook id, e.g. the `id` returned by [`clay webhooks list`](/cli/reference/webhooks-list). Required. |

## Output

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "ok": true
}
```

| Field | Type    | Description                             |
| ----- | ------- | --------------------------------------- |
| `ok`  | boolean | Always `true` when the delete succeeds. |

## Errors

| Code             | Exit | Notes                                            |
| ---------------- | ---- | ------------------------------------------------ |
| `auth_forbidden` | 3    | The API key lacks permission to manage webhooks. |
| `not_found`      | 6    | No webhook with that id.                         |

## Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay webhooks delete wh_abc123
clay webhooks list | jq -r '.data[0].id' | xargs clay webhooks delete
```
