Webhooks Overview

Webhooks let you receive HTTP POST notifications when events occur in Varda — new conversations, messages, calls, and more. Use them to integrate with your CRM, trigger Zapier workflows, or build custom automations.

How it works

1. Create a webhook endpoint in Settings > Webhooks
2. Choose which events to subscribe to
3. Varda sends an HTTP POST to your URL whenever a matching event occurs
4. Your server responds with 2xx to acknowledge receipt

Quick setup

# Create an endpoint via API
curl -X POST https://api.tryvarda.com/api/v1/webhook_endpoints \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/varda",
    "events": ["conversation.created", "call.ended"],
    "description": "CRM integration"
  }'

The response includes a secret — save it immediately, it’s only shown once. Use it to verify webhook signatures.

Reliability

• Retries — Failed deliveries are retried up to 5 times with exponential backoff
• Timeout — Requests timeout after 10 seconds
• Auto-disable — Endpoints are automatically disabled after 10 consecutive failures
• HTTPS only — Webhook URLs must use HTTPS

Payload format

Every webhook delivery includes:

{
  "event": "conversation.created",
  "timestamp": "2026-03-25T18:30:00Z",
  "data": {
    "id": 123,
    "status": "open",
    "contact": {
      "id": 456,
      "name": "John Smith",
      "email": "john@example.com",
      "phone": "+18005551234"
    },
    "attribution": {
      "source": "google_ads",
      "medium": "cpc",
      "campaign": "spring-sale",
      "gclid": "CjwKCAjw..."
    }
  }
}

Headers

Header	Description
Content-Type	application/json
X-Varda-Event	Event type (e.g., conversation.created)
X-Varda-Signature	HMAC signature for verification
X-Varda-Delivery	Unique delivery ID
User-Agent	Varda-Webhooks/1.0