---
title: "Webhooks"
description: "Los webhooks de entrada permiten que otro sistema envíe un formulario en nombre de un empleado. La vista Webhooks enumera cada webhook con su endpoint; abre uno para ver el estado de su secreto y su registro."
sidebar:
  label: Resumen
  order: 0
area: settings
feature: webhooks
appPath: /settings/general/webhooks
lastVerified: 2026-11-15
version: "2026-11-10"
audience: admin
related:
  - settings/webhooks/create-a-webhook-secret
  - flows/forms
  - notices
intercom:
  - id: "16858360"
    title: Create a Webhook (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16858360-create-a-webhook-pyn-2
    note: draws on
translation:
  source: settings/webhooks/index.mdx
  sourceSha: dd1218d30155660a0b00aca101164f1e7fc0f495
---

Un webhook de entrada es una dirección a la que otro sistema envía JSON. Cada webhook pertenece a un formulario: una carga que llega se convierte en un envío de ese formulario para el empleado que nombra la carga, y ese envío puede disparar una automation. Los webhooks se crean en el formulario, en su panel lateral **Webhook**; Settings los enumera todos en un solo sitio.

![Settings > General > Webhooks lists every inbound webhook created on a form.](https://support.pyn.ai/media/settings/webhooks/settings-webhooks-list.png)

## Cómo funciona un webhook

- El endpoint es `POST /api/webhook/<webhook id>` con la cabecera `Authorization: Bearer <secret>` y un cuerpo JSON. El panel muestra la **URL** y la **Header** que hay que enviar: "Post a JSON body here, with the secret as a bearer token."
- El cuerpo nombra al empleado con `subject_id` y las respuestas bajo `fields`. El ajuste **Subject** del formulario dice de qué sistema de origen viene ese id, por ejemplo un id de empleado de BambooHR.
- Cada llamada se responde con `202` en cuanto se acepta; la pestaña **History** es el registro de lo que fue de cada carga. Las entradas llevan un código como `submitted`, `unknown-subject`, `missing-fields`, `invalid-fields`, `ambiguous-fields` o `already-submitted`.
- Envía una cabecera `Idempotency-Key` para que los reintentos sean seguros: una repetición de la misma clave se responde otra vez con `202` pero no se procesa una segunda vez.
- Una carga que Pyn no pudo aceptar genera un aviso en [Notices](https://support.pyn.ai/es/notices/); un llamador que repite un mismo error actualiza un único aviso en lugar de generar muchos. También se puede enviar un correo a los administradores; consulta [Configura los correos de notificación](https://support.pyn.ai/es/settings/notifications/).
- Un webhook no acepta nada hasta que tiene un secreto, y un webhook archivado deja de aceptar cargas.

## Qué puedes hacer aquí

- [Crea o sustituye el secreto de un webhook](https://support.pyn.ai/es/settings/webhooks/create-a-webhook-secret/)
- Renombrar un webhook desde su panel: edita el **Title** y pulsa Enter, o haz clic fuera, para guardar
- Leer el **History** de cargas y exportar todo el registro como CSV desde el panel lateral Webhook del formulario
- Archivar un webhook desde su menú **...**

## Dónde está en la app

Abre `/settings/general/webhooks` en Pyn, o abre **Settings** en la navegación principal y selecciona **Webhooks** bajo **General**. Para crear un webhook, abre el formulario en [Forms](https://support.pyn.ai/es/flows/forms/), selecciona **Settings** en el carril y después **Add Webhook**.

## Relacionado

- [Crea o sustituye el secreto de un webhook](https://support.pyn.ai/es/settings/webhooks/create-a-webhook-secret/) antes de la primera carga.
- [Forms](https://support.pyn.ai/es/flows/forms/) para crear el webhook y elegir su subject.
- [Notices](https://support.pyn.ai/es/notices/) para las cargas que Pyn no pudo aceptar.
