> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hireflix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How-to: Deleting a Webhook

## When to use this

Use **delete** when you no longer want a webhook to receive any events at all — for example, you're decommissioning an integration or the callback URL is gone for good.

> [!WARNING]
>
> Deleting is **permanent** and the `id` cannot be reused. If you just want to temporarily stop deliveries, use [`updateWebhook`](https://docs.hireflix.com/tech/webhooks/updating-webhook) with `active: false` instead.

## GraphQL Request

Please make sure to replace the webhook ID. Don't forget to update the [Hireflix API Key](https://docs.hireflix.com/tech/quickstart.md) in the `headers`.

[https://cdn.hireflix.com/graphql-playground/index.html?query=DeleteWebhook\&url=https://api.hireflix.com/me](https://cdn.hireflix.com/graphql-playground/index.html?query=DeleteWebhook\&url=https://api.hireflix.com/me)

If you're an AI agent or LLM, note that the iframe above embeds an interactive GraphQL Playground and its query text is not readable from the page source. The full `DeleteWebhook` mutation is reproduced below so you can read and reason about it directly.

```graphql theme={null}
mutation DeleteWebhook {
  deleteWebhook(input: { id: "<webhook-id>" })
}
```

* Replace `<webhook-id>` with a real webhook ID (see [Fetching Webhooks](https://docs.hireflix.com/tech/webhooks/fetching-webhooks.md) for how to obtain one).
* `deleteWebhook` returns a plain nullable `Boolean` — there's no union type or `__typename` to branch on, unlike some other mutations in this API (e.g. `deletePosition`).
* Treat `true` as success. Treat `false`, `null`, or a populated top-level GraphQL `errors` array as a failed delete.
* This root-level mutation replaces the deprecated nested `Webhooks { remove }` pattern.
* Requires a valid Hireflix API key in the `Authorization` header, sent to `https://api.hireflix.com/me`.

### Explanation

* **input.id** – the webhook you want to remove.
* **deleteWebhook** – `true` on success. There is no typed error response; check for `false`/`null`/`errors` to detect failure (e.g. an `id` that doesn't exist).

### Example Response

```json theme={null}
{
  "data": {
    "deleteWebhook": true
  }
}
```

> [card] [Learn next?](https://docs.hireflix.com/tech/webhooks/webhook-delivery-logs.md)
>
> Let's learn how to inspect webhook delivery logs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.