Skip to main content
DocsWebhooksEndpoint Configuration

Endpoint Configuration

Configure your webhook endpoints, manage secrets, and control which agents trigger deliveries.

URL Requirements

  • HTTPS is required for all webhook endpoint URLs.
  • HTTP is allowed only for localhost, 127.0.0.1, and [::1] during development.
  • Your endpoint must respond within 10 seconds or the delivery will be treated as a failure.

Webhook Secrets

  • A unique secret is generated when you create an endpoint. It is displayed once. Copy it immediately and store it securely.
  • Secrets are encrypted at rest in our database. We cannot retrieve your original secret after creation.
  • You can regenerate a secret at any time from the dashboard. This immediately invalidates the old secret.

Per-Agent Enablement

When creating or editing an AI agent (phone employee or widget), you can toggle which webhook endpoints are active for that agent. This lets you:

  • Route events from different agents to different backend systems.
  • Reduce noise by only receiving events for agents you care about.
  • Test webhooks on a single agent before rolling out company-wide.

If no specific agents are assigned, the endpoint receives events from all agents in your company.

Webhook Endpoint Configuration