Skip to main content
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.
Think of it as three parts: agent switch, workspace URL, verification secret.

​
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.
LayerConfigured inPurpose
Agent webhook toggleAgent SettingsEnable or disable webhook behavior for a saved agent.
External webhook URLWebhooks tabChoose where workspace events are delivered.
Webhook secretKeys tabLet your receiver verify events.
Delivery logsWebhook delivery systemShow success, status code, errors, and retries.

​
Agent Webhook Confusions

Check the external webhook URL, active state, secret, and receiver logs.
Check secret rotation and verification code.
Confirm which agent version handled the call.

Agent Settings Webhook

Use the builder toggle.

External Webhooks

Configure receiver URL.

Webhook Secrets

Verify events.