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

# Delete Webhook

> Delete a webhook and all its delivery history

Permanently deletes a webhook and all associated delivery records. This action cannot be undone.

<Note>
  Webhook management is available only on plans that include webhook access.
</Note>

## Path Parameters

| Parameter | Type    | Required | Description |
| --------- | ------- | -------- | ----------- |
| `id`      | integer | Yes      | Webhook ID  |

### Request

```bash cURL theme={null}
curl -X DELETE "https://api.shoal.xyz/v1/webhooks/12" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```python Python theme={null}
import os, requests

API_KEY = os.environ.get("SHOAL_API_KEY", "YOUR_API_KEY")

r = requests.delete(
    "https://api.shoal.xyz/v1/webhooks/12",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.json())
```

```javascript JavaScript theme={null}
const API_KEY = process.env.SHOAL_API_KEY || 'YOUR_API_KEY';

const res = await fetch('https://api.shoal.xyz/v1/webhooks/12', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${API_KEY}` },
});
console.log(await res.json());
```

### Response (200)

```json theme={null}
{
  "success": true
}
```

### Errors

| Status | Error                  | Cause                                          |
| ------ | ---------------------- | ---------------------------------------------- |
| 400    | Webhook id is required | Missing or invalid ID                          |
| 404    | Webhook not found      | ID doesn't exist or belongs to another account |