How-to: Updating a Webhook

When to use this

Use updateWebhook to change an existing webhook’s url, subscribed events, or active state — without deleting and recreating it (which would generate a new id and a new signing relationship).

Only the Admin/Owner of your Hireflix account can update webhooks.

Before you start

You’ll need the webhook’s id. If you don’t have it, see Fetching Webhooks. Don’t forget to send your Hireflix API Key in the Authorization header to https://api.hireflix.com/me.

GraphQL Request

Explanation

• input.id – the webhook you want to update (required).
• input.url – new callback endpoint, if changing it.
• input.events – new full list of subscribed events — replaces the existing list entirely.
• input.active – true to keep/enable deliveries, false to pause them.

events is a full replacement, not a merge. If you only want to add one event to an existing subscription, first fetch the webhook’s current events via Fetching Webhooks, then send back the full combined list.

Example Response

{
  "data": {
    "updateWebhook": {
      "id": "68ff5ed8b07cc148bddcae02",
      "url": "https://your-new-callback-url",
      "events": ["interview.finish", "interview.resubmitted"],
      "active": true
    }
  }
}

Learn next?

Let’s learn how to delete a webhook.