Skip to main content

​
Overview

Levers webhooks enable your application to receive real-time notifications when important events occur, such as AI phone calls completing. Webhooks are delivered as HTTP POST requests to your configured endpoint.

How Webhooks Work

When an event occurs, Levers sends an HTTP POST payload to your webhook endpoint with event data and Svix signature headers.

When to Use

Webhooks are ideal for updating your database, triggering workflows, or sending notifications in response to events.

​
Setup Guide

Follow this step-by-step guide to configure webhooks in the Levers Dashboard:

​
Steps Covered in the Guide

  1. Create Webhook - Add a name and description for your webhook
  2. Configure Endpoint - Enter your webhook URL (e.g., from Beeceptor for testing)
  3. Select Events - Choose which events trigger the webhook (e.g., phone_call.ended)
  4. Test Your Setup - Trigger test events and verify the payload
  5. Inspect Headers - Review the Svix signature headers for verification

​
Security

Levers uses Svix to secure webhook deliveries. All webhook requests include:
  • Signature Headers: cryptographic signatures to verify the request originated from Levers
  • Timestamp Headers: to prevent replay attacks
  • Event IDempotency: each event has a unique ID to prevent duplicate processing

​
The Webhook Flow

1

Configure Your Endpoint

Create a publicly accessible HTTPS endpoint that accepts POST requests. Your endpoint should:
  • Respond with 200 OK within 30 seconds
  • Verify the Svix signature before processing
  • Handle duplicate events (idempotency)
2

Register Your Webhook

Add your webhook URL in the Levers Dashboard under Settings > Webhooks. You can:
  • Select which events to subscribe to
  • Add multiple endpoints for redundancy
  • Set secret keys for each endpoint
3

Receive Events

When a subscribed event occurs, Levers sends a POST request to your endpoint with:
  • JSON payload containing event data
  • Svix signature headers for verification
  • Event type and timestamp metadata
4

Verify and Process

Always verify the Svix signature headers, then process the event data according to your business logic.

​
Authentication

Webhook authentication uses the Svix signature verification method, which is different from the Bearer token authentication used for API calls. For API authentication, see the Introduction.

Webhook Verification

Learn how to verify webhook signatures using Svix.

Available Events

See all available webhook events and their payloads.