---
url: https://docs.youcan.shop/youcan-pay/webhooks/delete.md
---
# Delete a Webhook

Permanently deletes a webhook. Once deleted, no further notifications are delivered to its URL.

**Required scope (OAuth only):** `delete-webhook`

## Returns

Returns a deletion confirmation carrying the identifier of the deleted webhook.

## Request

**Endpoint:** `https://youcanpay.com/api/v2/webhooks/{webhook_id}`
**Method:** `DELETE`

```bash
$ curl --location -g --request DELETE 'https://youcanpay.com/api/v2/webhooks/9b1f2c34-5d6e-4a7b-8c9d-0e1f2a3b4c5d' \
  --header 'Accept: application/json' \
  -u 'YOUR_PRIVATE_KEY:'
```

## Response

```json
{
  "object": "v2.webhook",
  "id": "9b1f2c34-5d6e-4a7b-8c9d-0e1f2a3b4c5d",
  "deleted": true
}
```

## Errors

| Status | Description |
| --- | --- |
| `404` | No webhook with that identifier exists on this account. |