---
title: "Actualizar webhook"
method: PUT
path: "/v1/webhooks/{webhookId}"
tags: ["Webhooks"]
---

# Actualizar webhook

`PUT /v1/webhooks/{webhookId}`

Actualiza la configuración de un webhook existente. Solo se modifican los campos enviados en el body;
los demás se mantienen sin cambios.

## Path parameters

- `webhookId` string, required

## Request body

- UpdateWebhookRequest — Cuerpo para actualizar una suscripción a webhooks (todos los campos opcionales).
  - `url` string, uri — Nueva URL de destino.
  - `eventTypes` WebhookEventType[] — Nueva lista de eventos a los que suscribirse.
  - `isActive` boolean — Activar o pausar la suscripción.
  - `retryCount` integer — Nueva cantidad máxima de reintentos.
  - `customHeaders` object — Nuevos headers personalizados para cada entrega.

## Response `200`

Webhook 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

- `400` — Datos inválidos
- `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)