# Delete a webhook subscription.

`DELETE /webhooks/{id}`

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/rm-delete-webhook · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml · Operation ID: `rmDeleteWebhook` · Tag: Webhooks

Removes the subscription and stops all delivery to it. Its delivery history is removed with it.

## Request

`DELETE https://api.usewheelhouse.com/ss_api/v1/webhooks/{id}`

Authentication: send your RM API key in the `X-Integration-Api-Key` header (see https://docs.usewheelhouse.com/rm/authentication.md). Modifies data; read-only keys get `403 Forbidden`.

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer | yes | The Wheelhouse internal subscription ID. |

### Example request

```bash
curl -X DELETE 'https://api.usewheelhouse.com/ss_api/v1/webhooks/{id}' \
  -H 'X-Integration-Api-Key: <your RM API key>'
```

Only required parameters and body fields are filled in, with placeholder values. Add the optional ones you need from the lists above; some are required in combination, as their descriptions say.

## Responses

### 204

Subscription deleted.

### 401

API key authorization failed.

### 403

The API key is read-only and may not be used to delete a webhook.

### 404

No such webhook subscription for this user.

### 429

Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the **Rate Limits** section in the overview for the recommended exponential backoff strategy.

Body (`application/json`): object

- `error` (string, example: `API token is at rate limit`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "API token is at rate limit"
}
```
