> ## 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 Agent Webhooks For API Access

> Understand how DialNexa agent webhooks relate to workspace external webhooks, event delivery, agent settings, and receiver verification.

This page explains how the per-agent webhook toggle fits into the workspace webhook system. For the toggle itself - where it lives and how to enable it - see [Agent Webhooks in Agent Settings](/agent-settings/agent-webhooks).

<Tip>
  Think of it as three parts: agent switch, workspace URL, verification secret.
</Tip>

## Webhook Layers

Each layer has a different owner. Events flow only when all three are in place: the agent's toggle is on, the workspace has an external webhook URL, and the receiver verifies with the webhook secret.

| Layer                | Configured in                                                       | Purpose                                               |
| -------------------- | ------------------------------------------------------------------- | ----------------------------------------------------- |
| Agent webhook toggle | [Agent Settings](/agent-settings/agent-webhooks)                    | Enable or disable webhook behavior for a saved agent. |
| External webhook URL | [Webhooks tab](/api-access/external-webhooks)                       | Choose where workspace events are delivered.          |
| Webhook secret       | [Keys tab](/api-access/webhook-secrets)                             | Let your receiver verify events.                      |
| Delivery logs        | [Webhook delivery system](/api-access/webhook-retries-and-failures) | Show success, status code, errors, and retries.       |

## Agent Webhook Confusions

<AccordionGroup>
  <Accordion title="The agent toggle is on but no event arrives">
    Check the external webhook URL, active state, secret, and receiver logs.
  </Accordion>

  <Accordion title="The receiver rejects events">
    Check secret rotation and verification code.
  </Accordion>

  <Accordion title="The wrong agent triggers events">
    Confirm which agent version handled the call.
  </Accordion>
</AccordionGroup>

## Related Reading

<CardGroup cols={2}>
  <Card title="Agent Settings Webhook" icon="webhook" href="/agent-settings/agent-webhooks">
    Use the builder toggle.
  </Card>

  <Card title="External Webhooks" icon="webhook" href="/api-access/external-webhooks">
    Configure receiver URL.
  </Card>

  <Card title="Webhook Secrets" icon="key-round" href="/api-access/webhook-secrets">
    Verify events.
  </Card>
</CardGroup>