> ## Documentation Index
> Fetch the complete documentation index at: https://hireflixsl.mintlify.site/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`](/tech/webhooks/updating-webhook) with `active: false` instead.
</Warning>

## GraphQL Request

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

<iframe src="https://cdn.hireflix.com/graphql-playground/index.html?query=DeleteWebhook&url=https://api.hireflix.com/me" width="100%" height="750" />

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](/tech/webhooks/fetching-webhooks) 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 title="Learn next?" icon="arrow-right" color="#5863ff" horizontal href="/tech/webhooks/webhook-delivery-logs">
  Let's learn how to inspect webhook delivery logs.
</Card>
