> ## Documentation Index
> Fetch the complete documentation index at: https://developers.insuranceboosters.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook

> Inicia una automatización enviando una solicitud HTTP desde otro sistema.

Usa el trigger `webhook` cuando otro sistema deba decidir cuándo iniciar la automatización. Cada solicitud válida crea una ejecución.

## Configuración

```json theme={null}
{
  "type": "webhook"
}
```

No envíes un secreto al crear la automatización. La plataforma genera `trigger.secret` y lo devuelve en la respuesta.

## Cómo iniciarlo

**1. Crea la automatización**

Usa `{ "type": "webhook" }` en `trigger`.

**2. Publica y activa**

Una automatización sin versión publicada o desactivada no acepta solicitudes.

**3. Envía una solicitud**

Haz `POST` a la URL que contiene `workflowId` y `secret`. Consulta [Disparar webhook](https://developers.insuranceboosters.com/automatizaciones/disparar-webhook.md).

## Datos disponibles en los pasos

El JSON que envías queda en `trigger.body`. Los headers y parámetros de URL quedan en `trigger.headers` y `trigger.query`.

Envía `Content-Type: application/json`. La API rechaza bodies mayores a 50 MB, pero ese valor no garantiza que un evento de ese tamaño pueda guardarse como ejecución. Mantén el body pequeño y guarda archivos en almacenamiento externo.

Si envías:

```json theme={null}
{
  "reference": "PAY-1001",
  "amount": 1250
}
```

puedes preparar el `input` de un paso así:

```json theme={null}
{
  "reference": "{{trigger.body.reference}}",
  "amount": "{{trigger.body.amount}}"
}
```

## Cuándo se acepta la solicitud

La API crea una ejecución cuando:

* el `workflowId` existe;
* el `secret` de la URL coincide;
* el trigger sigue siendo `webhook`;
* la automatización está publicada y activa;
* la cuenta no alcanzó su límite de ejecuciones activas.

Una solicitud aceptada responde `202` con un `runId`. Consulta [Disparar webhook](https://developers.insuranceboosters.com/automatizaciones/disparar-webhook.md) para ver la URL, respuesta y errores.

> [!WARNING]
>
> Este trigger no deduplica solicitudes. Si tu cliente reintenta el mismo POST, la plataforma crea otra ejecución. Incluye un ID propio en el body y consulta [Reintentos e idempotencia](https://developers.insuranceboosters.com/automatizaciones/triggers/reintentos-idempotencia.md).

## Cuándo usar otro trigger

* Usa [Programación](https://developers.insuranceboosters.com/automatizaciones/triggers/programacion.md) si conoces la fecha u horario.
* Usa un trigger de [Registro creado](https://developers.insuranceboosters.com/automatizaciones/triggers/registro-creado.md) o [Registro actualizado](https://developers.insuranceboosters.com/automatizaciones/triggers/registro-actualizado.md) si el evento ocurre en un tablero.

## Relacionado

* [Disparar webhook](https://developers.insuranceboosters.com/automatizaciones/disparar-webhook.md)
* [Variables y contexto](https://developers.insuranceboosters.com/automatizaciones/variables-y-contexto.md)
* [Consultar ejecución](https://developers.insuranceboosters.com/automatizaciones/consultar-ejecucion.md)
* [Reintentos e idempotencia](https://developers.insuranceboosters.com/automatizaciones/triggers/reintentos-idempotencia.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.