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

# DialNexa Webhook Secrets

> Create, rotate, view, copy, edit, and delete DialNexa webhook secrets used to verify external webhook events.

DialNexa webhook secrets are organization-level credentials used by receiving systems to verify webhook events. The Keys page lets users create a webhook secret, copy the raw secret, show or hide it in the table, edit its name, delete it, and rotate it with a clear warning.

<Warning>
  Rotating a webhook secret can permanently replace the existing secret. Update receivers before they start rejecting valid events.
</Warning>

## Webhook Secret Actions

Webhook secrets share the Keys page but serve a different purpose from API keys.

| Action        | Behavior                                                                |
| ------------- | ----------------------------------------------------------------------- |
| Create secret | Creates a named webhook secret and shows the raw secret.                |
| Rotate secret | Warns that creating a new one will permanently delete the existing one. |
| Show or hide  | Toggles whether the secret value is visible in the table.               |
| Copy          | Copies the secret value.                                                |
| Edit name     | Changes the visible label.                                              |
| Delete        | Removes the webhook secret.                                             |

## Rotate A Webhook Secret Safely

<Steps>
  <Step title="Open Keys">
    Use the correct workspace.
  </Step>

  <Step title="Choose Add Key then Webhook Secret">
    If one exists, read the rotation warning.
  </Step>

  <Step title="Create and copy the new secret">
    Store it in the receiving system.
  </Step>

  <Step title="Update verification logic">
    Deploy the receiver with the new secret.
  </Step>

  <Step title="Send a test event">
    Place a test call and confirm the receiver accepts it.
  </Step>
</Steps>

## Webhook Secret Questions

<AccordionGroup>
  <Accordion title="Is this the same as an API key?">
    No. API keys authenticate requests to DialNexa. Webhook secrets verify events sent from DialNexa.
  </Accordion>

  <Accordion title="Why did my webhook become inactive?">
    An external webhook can depend on a configured secret. Check the Webhooks page status.
  </Accordion>

  <Accordion title="Can I recover an old secret?">
    Plan as if rotated secrets cannot be recovered from the dashboard.
  </Accordion>
</AccordionGroup>

## Related Reading

<CardGroup cols={2}>
  <Card title="External Webhooks" icon="webhook" href="/api-access/external-webhooks">
    Configure event URL.
  </Card>

  <Card title="Webhook Failures" icon="refresh-cw" href="/api-access/webhook-retries-and-failures">
    Debug delivery.
  </Card>

  <Card title="Agent Webhooks" icon="bell" href="/api-access/agent-webhooks">
    Enable events for agents.
  </Card>
</CardGroup>