---
title: Crea o sustituye el secreto de un webhook
description: Genera el secreto bearer que un webhook necesita antes de aceptar cargas, cópialo una sola vez y rótalo cuando se pierda o quede expuesto.
sidebar:
  order: 2
area: settings
feature: webhooks
appPath: /settings/general/webhooks
lastVerified: 2026-11-02
version: "2026-10-30"
audience: admin
related:
  - settings/webhooks
  - flows/forms
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/create-a-webhook-secret.mdx
  sourceSha: 132b69427936f3533202abf3fcb53c5ab17e51b5
---

Un webhook se crea en un formulario pero no acepta nada hasta que tiene un secreto. Generas el secreto desde el panel del webhook, lo copias en el sistema que llama y lo sustituyes si se filtra o el otro sistema lo pierde. El secreto se muestra una sola vez y no se puede volver a leer.

## Antes de empezar

- Eres admin u owner.
- El webhook existe. Si no, abre el formulario en [Forms](https://support.pyn.ai/es/flows/forms/), selecciona **Settings** en el carril y después **Add Webhook**.
- Tienes un lugar seguro donde pegar el secreto, como el almacén de credenciales del sistema que llama.

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

## Pasos

1. En Pyn, abre **Settings** en la navegación izquierda y después **Webhooks** bajo **General**.

2. Selecciona el webhook. Se abre su panel; sin secreto dice "This webhook accepts nothing until it has a secret."

3. Selecciona **Create Secret**. El panel muestra el secreto con "Copy this secret now. It is shown once and cannot be retrieved later." Si el secreto no se puede generar, un toast dice **Could not create the secret** y el panel se queda como estaba.

4. Cópialo, guárdalo en el sistema que llama y después selecciona **Done**.

5. Copia la **URL** que aparece bajo "Post a JSON body here, with the secret as a bearer token." y configura el sistema que llama para que envíe `Authorization: Bearer <secret>` con un cuerpo JSON.

6. Para rotarlo más adelante, selecciona **Replace Secret**. La confirmación advierte "The current secret stops working immediately. Anything calling this webhook will need the new one." Selecciona **Replace** y copia el valor nuevo. Si el secreto no se puede sustituir, un toast dice **Could not replace the secret** y el antiguo sigue funcionando.

> **Caution:** La sustitución surte efecto en el momento en que confirmas. Actualiza el sistema que llama justo después, o su siguiente carga se rechaza.

## Qué deberías ver

Con un secreto en su sitio, el panel dice "This webhook already has a secret. Replace it if the old one has been lost." Envía una carga de prueba desde el otro sistema: la pestaña **History** la muestra en unos segundos con su resultado, `submitted` para una carga que se convirtió en un envío, o un código de motivo como `unknown-subject`. Una carga enviada con un secreto incorrecto o ausente se responde con `404` y no aparece en el registro.

## Relacionado

- [Webhooks](https://support.pyn.ai/es/settings/webhooks/) para la forma de la carga y los códigos de resultado.
- [Forms](https://support.pyn.ai/es/flows/forms/) para crear el webhook y definir su subject.
