---
title: "Activar o desactivar webhook"
method: PATCH
path: "/v1/webhooks/{webhookId}"
tags: ["Webhooks"]
---

# Activar o desactivar webhook

`PATCH /v1/webhooks/{webhookId}`

Activa o desactiva un webhook sin eliminarlo. Un webhook desactivado no recibe entregas
pero mantiene su configuración y logs.

## Path parameters

- `webhookId` string, required

## Request body

- object
  - `isActive` boolean, required — `true` para activar, `false` para desactivar

## Response `200`

Estado actualizado

- WebhookSubscription — Suscripción a webhooks: una URL tuya que recibe por POST los eventos seleccionados (conversaciones y contactos) en tiempo real.
  - `id` string — ID de la suscripción.
  - `companyId` string — ID de la empresa dueña de la suscripción.
  - `websiteId` string — ID del canal o `*` para todos los canales
  - `url` string, uri
  - `eventTypes` WebhookEventType[]
  - `isActive` boolean
  - `secret` string — Token secreto enviado en el header `X-Webhook-Secret` de cada entrega
  - `retryCount` integer — Cantidad máxima de reintentos en caso de fallo (backoff exponencial)
  - `customHeaders` object — Headers personalizados enviados con cada entrega
  - `createdAt` string, date-time — Fecha de creación de la suscripción.
  - `updatedAt` string, date-time — Fecha de última modificación.

## Other responses

- `404` — Webhook no encontrado

---

[API](https://skmtc.net/cliengo/apis/cliengo-public-api.md) · [All operations](https://skmtc.net/cliengo/apis/cliengo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cliengo/cliengo-public-api/revisions/94c7ba7d6a11/schema)