---
title: "Crea un webhook"
description: "Deja que otro sistema envíe un formulario en nombre de un empleado: añade un webhook al formulario, elige qué id del HRIS identifica al empleado, genera el secreto una sola vez y lee el registro de lo que ha llegado."
sidebar:
  order: 2
area: flows
feature: forms
appPath: /flows/home
lastVerified: 2026-11-15
version: "2026-10-30"
audience: admin
screenshots:
  - id: flows-forms-webhook-drawer
    caption: El panel lateral Settings de un formulario, con la URL, la cabecera, el sujeto y el cuerpo de ejemplo del webhook.
related:
  - flows/forms/reference-webhook-api
  - flows/forms/build-a-form
  - notices
intercom:
  - id: "16858360"
    title: Create a Webhook (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16858360-create-a-webhook-pyn-2
    note: replaces
translation:
  source: flows/forms/create-a-webhook.mdx
  sourceSha: 88dd3263f023bcd0343ab040ded33eaba8203476
---

Algunas respuestas ya existen en otro sistema: una formación completada en tu LMS, una solicitud de equipo en una herramienta de tickets, un documento firmado. Un webhook en un formulario permite que ese sistema publique la respuesta en Pyn como un envío, que queda asociado al empleado que nombra.

## Antes de empezar

- Eres Admin.
- El formulario está construido y publicado, con etiquetas de campo que tu otro sistema pueda mapear. Consulta [Crea un formulario](https://support.pyn.ai/es/flows/forms/build-a-form/).
- El otro sistema puede enviar el id de cada empleado en tu HRIS, el mismo id que Pyn tiene de esa integración.

![El panel lateral Settings de un formulario, con la URL, la cabecera, el sujeto y el cuerpo de ejemplo del webhook.](https://support.pyn.ai/media/flows/forms/flows-forms-webhook-drawer.png)

## Pasos

1. En Pyn, abre **Flows** en la navegación izquierda, selecciona **Forms** y después el formulario.

2. Selecciona **Settings** en la barra a la derecha del editor. El panel lateral dice **Add a webhook to let another system submit this form on an employee's behalf.** Selecciona **Add Webhook**. Si el webhook no se puede añadir, un toast dice **Could not add this webhook** y el panel lateral se queda como estaba.

3. En la parte superior del panel lateral, el aviso dice **This webhook accepts nothing until it has a secret.** Selecciona **Create Secret**; el aviso pasa a decir **Copy this secret now. It is shown once and cannot be retrieved later.** Cópialo en el otro sistema y después selecciona **Done**. Si el secreto no se puede generar, un toast dice **Could not create the secret** y el aviso se queda como estaba. Un webhook que ya tiene secreto dice **This webhook already has a secret. Replace it if the old one has been lost.** y ofrece en su lugar **Replace Secret**; mira más abajo.

4. Bajo el aviso, copia la **URL** y anota la cabecera: `Authorization: Bearer <secret>`.

5. En **Subject**, selecciona el sistema de origen cuyo id enviará el otro sistema, por ejemplo **BambooHR Employee ID** o **Workday Worker ID**. La descripción dice **The submission is recorded against the employee holding this id.**

6. Lee el ejemplo bajo **Post a body of this shape.** Nombra cada campo por su alias (la etiqueta en camel case) con un valor de ejemplo, más `subject_id`.

7. Envía una carga de prueba desde el otro sistema y lee el registro al pie del panel lateral (**Payloads this webhook has taken, and what became of them.**). Una entrada verde dice **Recorded a submission for the ... identifier ...**; una roja nombra el problema.

> **Caution:** Un secreto perdido no se puede recuperar. Selecciona **Replace Secret** para generar uno nuevo; el cuadro de diálogo **Replace Webhook Secret** advierte **The current secret stops working immediately. Anything calling this webhook will need the new one.** y **Replace** lo confirma. Si el secreto no se puede reemplazar, un toast dice **Could not replace the secret** y el antiguo sigue funcionando.

## Rotar el secreto y leer el registro

- **Replace Secret** rota el secreto en un solo paso y el antiguo deja de funcionar de inmediato; actualiza el sistema que llama antes de confirmar.
- El registro muestra las 20 entradas más recientes. En cuanto hay una entrada, un icono de exportación a su lado descarga el registro completo como `pyn-webhook-log.csv` (`receivedAt`, `outcome`, `action`, `code`, `message`, `eventId`, `subjectId`, `submissionId`).
- Una carga descartada también genera un aviso en [Notices](https://support.pyn.ai/es/notices/), y el mismo error repetido mantiene un único aviso vigente en lugar de muchos; su fila ofrece **Acknowledge** y después **Archive**. La configuración de notificaciones del workspace decide si se envía un correo a todos los admins o solo al owner.

## Qué deberías ver

Las cargas aceptadas aparecen como envíos en el panel lateral **Activity** del formulario, y el registro del empleado lleva cualquier valor de Buddy o Mentor. Cada webhook admite un solo envío por empleado; una repetición se registra como `already-submitted`. [API del webhook](https://support.pyn.ai/es/flows/forms/reference-webhook-api/) enumera el endpoint, las cabeceras, el cuerpo, las respuestas y todos los códigos del registro.

## Relacionado

- [API del webhook](https://support.pyn.ai/es/flows/forms/reference-webhook-api/) para la petición y las respuestas exactas.
- [Crea un formulario](https://support.pyn.ai/es/flows/forms/build-a-form/) para los campos que rellena una carga.
- [Notices](https://support.pyn.ai/es/notices/) para ver dónde afloran los fallos.
