---
title: "Crear webhook"
method: POST
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# Crear webhook

`POST /v1/webhooks`

Crea una nueva suscripción de webhook. Cliengo enviará un `POST` a la URL indicada cada vez que ocurra
uno de los eventos seleccionados. El webhook se crea activo por defecto y se le asigna un `secret`
que se enviará en el header `X-Webhook-Secret` de cada entrega para verificar autenticidad.

## Request body

- CreateWebhookRequest — Cuerpo para crear una suscripción a webhooks.
  - `url` string, uri, required — URL donde Cliengo enviará los eventos via POST
  - `eventTypes` WebhookEventType[], required — Eventos a los que suscribirse (al menos uno)
  - `websiteId` string — ID del canal. Usar `*` o omitir para recibir eventos de todos los canales
  - `retryCount` integer — Reintentos en caso de fallo (0 = sin reintentos, máximo 10)
  - `customHeaders` object — Headers extra a incluir en cada entrega

## Response `201`

Webhook creado

- 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 (URL vacía, evento desconocido, etc.)

---

[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)