Quickstart

1. Get your API key

Log in to app.sendora.ai
Navigate to Settings → API Keys
Click Generate new key
Copy the key, it starts with sk_live_ or sk_test_. Do not assume a test-prefixed key is isolated from production side effects.

API keys are shown once. Store yours in a secrets manager (AWS Secrets Manager, Vault, .env file) immediately. If you lose it, generate a new one.

2. Make a test request

Verify your key works by fetching your leads:

curl https://api.sendora.ai/api/v1/public/leads \
  -H "X-API-Key: sk_live_your_key_here"

import httpx

client = httpx.Client(
    base_url="https://api.sendora.ai",
    headers={"X-API-Key": "sk_live_your_key_here"},
)

resp = client.get("/api/v1/public/leads")
print(resp.json())

const resp = await fetch("https://api.sendora.ai/api/v1/public/leads", {
  headers: { "X-API-Key": "sk_live_your_key_here" },
});
const data = await resp.json();
console.log(data);

req, _ := http.NewRequest("GET", "https://api.sendora.ai/api/v1/public/leads", nil)
req.Header.Set("X-API-Key", os.Getenv("SENDORA_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

You should get back a JSON envelope:

{
  "items": [...],
  "total": 142,
  "page": 1,
  "per_page": 50
}

3. Create a lead

This changes workspace data but does not send a message or start a call. Use a test workspace and a synthetic address while validating your integration.

curl -X POST https://api.sendora.ai/api/v1/public/leads \
  -H "X-API-Key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "jane@acme.com",
    "company": "Acme Corp",
    "phone_number": "+14155550123"
  }'

resp = client.post("/api/v1/public/leads", json={
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "jane@acme.com",
    "company": "Acme Corp",
    "phone_number": "+14155550123",
})
lead = resp.json()
print(lead["id"])

All Sendora write operations are idempotent, submitting the same request twice produces the same result without side effects. Enrolling a lead who is already in a campaign returns skipped: 1 rather than an error. Safe to retry on network failures.

4. Enroll the lead into a campaign

curl -X POST "https://api.sendora.ai/api/v1/public/campaigns/{campaign_id}/leads" \
  -H "X-API-Key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "lead_ids": ["<lead_id_from_step_3>"] }'

{ "enrolled": 1, "skipped": 0, "total_requested": 1 }

5. Register a webhook (optional)

Get notified when things happen:

curl -X POST https://api.sendora.ai/api/v1/public/webhook-endpoints \
  -H "X-API-Key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/sendora-webhook",
    "event_types": ["reply.received", "meeting.booked", "campaign.finished"]
  }'

Sendora will now POST signed payloads to your URL whenever those events fire. See Webhooks for the full event catalog and signature verification.

Next steps

Leads guide

Import, enrich, and update lead data at scale.

Campaigns guide

Launch and control multi-channel outreach sequences.

Webhooks guide

Real-time events for every key action.

Full API reference

Every endpoint with interactive playground.

Getting Started

Guides

1. Get your API key

2. Make a test request

3. Create a lead

4. Enroll the lead into a campaign

5. Register a webhook (optional)

Next steps

Leads guide

Campaigns guide

Webhooks guide

Full API reference

​1. Get your API key

​2. Make a test request

​3. Create a lead

​4. Enroll the lead into a campaign

​5. Register a webhook (optional)

​Next steps

Leads guide

Campaigns guide

Webhooks guide

Full API reference

1. Get your API key

2. Make a test request

3. Create a lead

4. Enroll the lead into a campaign

5. Register a webhook (optional)

Next steps