# deleteWebhookSubscription

Mutation

Hard-delete a webhook subscription (cascades its deliveries).

Available to agents as MCP tool `deleteWebhookSubscription` — see [Write tools](/api/v2/docs/mcp/write-tools#delete-webhook-subscription).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `id` | `ID!` | Yes | — | UUID of the subscription to delete. |

## Returns

| Name | Type | Description |
| --- | --- | --- |
| `deletedWebhookSubscriptionId` | `ID` | ID of the deleted subscription. Null when no such subscription exists in the workspace. |
| `userErrors` | [`[UserError!]!`](/api/v2/docs/types/user-error) | List of user-facing errors. Populated only when deletion failed. |

## Examples

### Delete a webhook subscription

Hard-delete a subscription and cascade its deliveries. The subscribed content views survive. Irreversible — pause via updateWebhookSubscription if you may want it back.

```graphql
mutation DeleteWebhookSubscriptionDefault($id: ID!) {
  deleteWebhookSubscription(id: $id) {
    deletedWebhookSubscriptionId
    userErrors {
      field
      message
    }
  }
}
```

Variables:

```json
{
  "id": "eb418e28-bf9d-5350-b87b-446a6813bca4"
}
```

Response — HTTP 200:

```json
{
  "data": {
    "deleteWebhookSubscription": {
      "deletedWebhookSubscriptionId": "eb418e28-bf9d-5350-b87b-446a6813bca4",
      "userErrors": []
    }
  }
}
```