Partner API v1Webhooks in preview
Post leads.
Get outcomes back.
Send Entrovox a data lead. An AI voice agent calls it, follows up on the sequence we set up with you, and warm-transfers qualified buyers to your licensed agents. Dispositions, transcripts and recordings come back to you.
- Base URL
- https://api.entrovox.com/v1
- Auth
- Authorization: ApiKey $ENTROVOX_KEY
- Format
- JSON · E.164 phones
curl -X POST https://api.entrovox.com/v1/leads \
-H "Authorization: ApiKey $ENTROVOX_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"first_name": "Test", "last_name": "Lead",
"phone": "+15555550100",
"external_id": "hw-1",
"is_test": true
}'import os, uuid, requests
r = requests.post(
"https://api.entrovox.com/v1/leads",
headers={
"Authorization": f"ApiKey {os.environ['ENTROVOX_KEY']}",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"first_name": "Test", "last_name": "Lead",
"phone": "+15555550100",
"external_id": "hw-1",
"is_test": True,
},
)import { randomUUID } from "node:crypto";
const res = await fetch("https://api.entrovox.com/v1/leads", {
method: "POST",
headers: {
Authorization: `ApiKey ${process.env.ENTROVOX_KEY}`,
"Idempotency-Key": randomUUID(),
"Content-Type": "application/json",
},
body: JSON.stringify({
first_name: "Test",
last_name: "Lead",
phone: "+15555550100",
external_id: "hw-1",
is_test: true,
}),
});201Created
{
"data": {
"id": "7c2e1a90-2b1f-4d3a-9e0c-0b8c1d2e3f40",
"current_disposition": "pending",
"is_test": true,
"status_url": "https://api.entrovox.com/v1/leads/7c2e…"
}
}is_test leads are stored and never called or texted. Safe to run right now.
Send us leads
Pick the path that matches how you sell leads today.
Direct postOne lead at a time, as it arrives. First dial is immediate inside calling hours.POST
/v1/leadsBatch postUp to 500 aged or unsold leads per request, with one result per row.POST/v1/leads/batchMediaAlpha native postPost your MediaAlpha JSON unchanged. We map the fields to an Entrovox lead.OpenAPI spec · JSON or YAMLPing, then postOnly if your publisher already speaks ping/post. A ping creates and reserves nothing.POST/v1/leads/pingGet outcomes back
Poll the status URL
LiveEvery accepted lead returns a status_url. It holds the lead-level disposition and each call attempt, with links to its transcript, recording and analysis.
- current_disposition
- qualified_transfer
- calls[0].call_outcome
- connected_transferred
- calls[0].recording_url
- /v1/calls/…/recording-url
Receive webhooks
PreviewSigned events pushed to your URL. The contract is final; delivery turns on in a later release. Write your LMS on call.recording.ready.
lead.acceptedcall.completedcall.transferredcall.recording.readycallback.scheduled+5 moreAPI reference
Leads
- POSTCreate a lead
- POSTBatch create leads
- POSTPing a lead
- GETRetrieve a lead
- GETList leads
- POSTPause a lead
- POSTResume a lead
Concepts
Webhooks and errors
Building with an AI coding assistant?
Every page is also plain Markdown. Point Claude, Cursor or ChatGPT at the index and it reads the whole API.