# Unsubscribe from an event webhook

`POST /webhook.unsubscribe`

## Description

Remove a webhook subscription by ID.

The request body is JSON: `{"id": "<subscription uuid>"}`. This differs
from v0, which expects `application/x-www-form-urlencoded` with the same
`id` field. Sending JSON to `/v0/webhook.unsubscribe` returns
`id parameter required`.

**Required scope:** `webhook:write`

---

**OpenAPI Spec:** [webhooks-v1.json](https://developer.ro.am/webhooks-v1.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Request Body

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | string | Yes | Identifier of the webhook subscription to remove. |

### Example Request

```json
{
  "id": "19c6401f-6d02-4d8c-87c5-9fc45f02f4b5"
}
```

## Responses

### 204 - Subscription deleted.

### 400 - Bad request.

### 401 - Presented invalid authentication credentials.

### 404 - Subscription not found.

### 500 - An internal error occurred.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/webhooks/webhook-unsubscribe*