# Delete webhook

`DELETE https://api.cryptohopper.com/v1/api/webhooks`

Part of [Webhooks](https://www.cryptohopper.com/api-documentation/api-reference/webhooks.md) in the Cryptohopper API reference.

Turns off your app's webhook with the given URL, so it stops receiving deliveries. Creating a webhook with the same URL turns it on again.

Needs a valid access token; no scope is checked.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |
| `lang` | string | no | Not used by this endpoint. |

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `webhook_url` | string | yes |  |

## Example request

```bash
curl -X DELETE "https://api.cryptohopper.com/v1/api/webhooks" \
  -H "access-token: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url":"https://example.com/cryptohopper/webhook"}'
```

## Response

Example response (illustrative values):

```json
{
    "data": {
        "message": "Webhook has been deleted.",
        "id": "1234",
        "webhook_url": "https://example.com/cryptohopper/webhook"
    }
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.