---
title: "Enable/Disable A Webhook"
method: PATCH
path: "/v0/webhooks/{webhook_id}/status"
tags: ["Webhooks"]
---

# Enable/Disable A Webhook

`PATCH /v0/webhooks/{webhook_id}/status`

By disabling a webhook, it will stop listening to events. When you enable a webhook, it will process all the events that have not been processed yet since you disabled it.

## Path parameters

- `webhook_id` integer, required — ID of the webhook

## Request body

- WebhookStatusUpdate
  - `is_active` boolean, required

## Response `200`

Successful Response

- WebhookResponseV0
  - `url` string, uri, required — URL of the webhook
  - `search_id` integer, required — ID of the search that the webhook is listening to.
  - `description` string, nullable — Description of the webhook
  - `listening_start_time` string, date-time, nullable — Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.
  - `trigger_once_per_company` boolean — Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered
  - `active_event_types` WebhookEventType[], required
  - `id` integer, required
  - `user_id` integer, required
  - `team_id` integer, required
  - `is_active` boolean, required
  - `is_archived` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `search_name` string, required
  - `webhook_type` 'jobs' | 'companies', required
  - `scanning_frequency` string — Scanning frequency for the webhook
  - `has_secret` boolean, required
  - `event_type` 'job_new' | 'company_new' | 'job_closed', required

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.net/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/versions/64902095234a/schema)