API Documentation

Authentication

Create an API key from your account under Profile → CRM Integrations → API Keys, then send it as a Bearer token on every request:

Authorization: Bearer ldk_your_key_here

Base URL: https://leadialer.com/api/v1 — all endpoints are HTTPS-only and scoped to your account.

Create a lead

POST /api/v1/leads
Content-Type: application/json

{
  "firstName": "Jane",
  "lastName": "Doe",
  "phone": "+15551234567",        // required
  "email": "jane@example.com",
  "propertyAddress": "123 Main St",
  "propertyCity": "Austin",
  "propertyState": "TX",
  "propertyZip": "78701",
  "notes": "From website form",
  "campaignId": 42                 // optional — one of your campaigns
}

Returns 201 with the created lead, 409 if the phone is a duplicate in that campaign or on your Do Not Call list.

List / fetch leads

GET /api/v1/leads?status=active&page=1&limit=50
GET /api/v1/leads?phone=+15551234567
GET /api/v1/leads/123

Webhook payloads

Add webhook endpoints under Profile → CRM Integrations → Outgoing Webhooks. Events POST JSON to your endpoint with an X-Leadialer-Event header and an X-Leadialer-Signature header (hex HMAC-SHA256 of the raw body using your endpoint's signing secret).

{
  "event": "appointment.booked",
  "timestamp": "2026-07-18T15:30:00.000Z",
  "data": {
    "appointmentId": 88,
    "leadId": 123,
    "leadName": "Jane Doe",
    "scheduledAt": "2026-07-21T19:00:00.000Z",
    "timezone": "America/Chicago",
    "source": "ai_call"
  }
}

Other events: call.completed (outcome, lead score, summary), lead.warm (score above 50), lead.opted_out (lead texted STOP — remove them from your CRM campaigns too).

Zapier setup (no code)

1. Leads in: in Zapier, add an action "Webhooks by Zapier → POST" pointing at /api/v1/leads, with header Authorization: Bearer ldk_… and your lead fields as JSON.
2. Events out: create a Zap starting with "Webhooks by Zapier → Catch Hook", copy the hook URL, and add it as a webhook endpoint in your account. Every call, booking, warm lead, and opt-out then flows into any app Zapier supports.
3. Use the "Test" button in your account to send a sample event and finish the Zap setup.

Step-by-step guides for specific tools: Zapier, Salesforce, Podio, REsimpli, and InvestorFuse — or browse all integrations, including the native Follow Up Boss, GoHighLevel, and HubSpot connectors that need no code at all.