Agents, numbers & senders API
Create and update agents programmatically, attach phone numbers or email senders, upload knowledge documents, and query usage metrics per workspace.
Developers & API
Skip building telephony plumbing, SMS thread memory, and email triggers from scratch. Use Teli's REST API and webhooks instead.
curl -X POST https://api.theteli.com/v1/agents \
-H "Authorization: Bearer $TELI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Inbound & Follow-up Agent",
"channels": ["voice", "sms", "email"],
"knowledge_base_id": "kb_94f1a",
"calendar_provider": "google",
"daily_spend_cap_usd": 50
}'Illustrative endpoint shapes shown above. Full OpenAPI reference ships with workspace API access.
API surface
Create and update agents programmatically, attach phone numbers or email senders, upload knowledge documents, and query usage metrics per workspace.
Keys are isolated to a single workspace, displayed once on creation, and metered with per-key rate limits and spend visibility.
Give your agent typed HTTPS endpoints to call live during a phone call, SMS thread, or email triage to check inventory, CRMs, or custom business logic.
Every event is HMAC-signed, retried with exponential backoff on failure, and recorded in a searchable webhook delivery log inside your workspace.
Event stream
call.started / call.endedFires when an inbound or outbound voice session connects and when it finishes with duration and status.
transcript.readyDelivers full speaker-labeled transcript, concise summary, and extracted customer intent.
sms.received / sms.sentStreams two-way text message payloads, thread IDs, and delivery receipts.
email.dispatchedConfirms confirmation, follow up, or invoice email delivery and template metadata.
booking.created / booking.updatedEmits structured calendar slot details whenever an appointment is scheduled, moved, or canceled.
tool.failedAlerts your engineering team immediately if a custom endpoint times out or returns a non-2xx response.