Your independent gateway to the Votel AI platform
Independent affiliate gateway. We are a Votel affiliate partner. This site is not Votel's official site — it introduces the Votel software and links you to Votel through our affiliate link. If you sign up, we may earn a commission, at no extra cost to you.
Docs Home · Getting Started · AI Agents · Prompt Guide · Phone & Calling · Workflows · Conversations · Contacts & CRM · Forms · Email Agents · AI Websites · Click Tracking · Payments & Billing · Integrations · Settings · Tasks · API · FAQ Library · Videos
Build with the Votel API to create AI voice agents, send messages, manage contacts, trigger workflows, and retrieve results programmatically. Version 1.0.0.
The API is organized to match the Votel app, so you can find endpoints for anything you do in the dashboard:
| App section | What you can do via the API |
|---|---|
| Conversations | Read inbox threads, send messages (SMS, email, WhatsApp), manage quick replies, configure channels |
| Calendars | Create booking pages, manage availability & staff, accept bookings, handle waitlists |
| Contacts | Create and search leads, import/export, custom fields, pipeline stages, activity timelines |
| Tasks | Create and assign tasks, custom task fields, saved task views |
| Agents | Build and deploy AI voice agents, manage versions, knowledge bases, TTS voices, AI generation |
| Activity | Query call logs, meeting logs, phone/widget/workflow reports, messaging logs |
| Workflows | Create automations, set triggers, enroll contacts, manage variables and campaigns |
| Communication | Send SMS and emails directly, manage email templates |
| Payments | Manage billing, products, and subscriptions |
| Click Tracking | Create tracking links, monitor clicks, conversions, landing pages, and traffic sources |
| Settings | API keys, users, sub-accounts, phone numbers, integrations, domains, and more |
Authenticate every request with your API key in the X-API-Key header:
X-API-Key: sk_your_api_key_here
Create and manage API keys in the app under Settings. Keep your API key secret — never expose it in client-side code or public repositories.
https://app.votel.ai/api
All endpoints are relative to this base URL.
List your AI agents:
curl https://app.votel.ai/api/agents -H "X-API-Key: sk_your_api_key_here"
Response:
[{ "id": "a1b2c3d4-...", "name": "Sales Assistant", "enabled": true }]
If you get a 200 OK, you are ready to start building. The same call works from Python (requests.get with the header), JavaScript (fetch), or PHP (cURL) — only the header matters.
The API accepts and returns JSON. Set Content-Type: application/json on requests with a body. When an error occurs, the response includes a detail message:
{ "detail": "Lead not found" }
| Code | Meaning |
|---|---|
200 | Success |
201 | Created |
400 | Bad request — check your parameters |
401 | Unauthorized — invalid or missing API key |
402 | Payment required — insufficient wallet balance |
403 | Forbidden — upgrade required or insufficient permissions |
404 | Not found |
429 | Rate limited — back off and retry |
500 | Server error |
When you hit a rate limit, the API returns 429 Too Many Requests with a Retry-After header. Design your integration to retry with exponential backoff.
The full reference runs to 1,700+ endpoint pages. The largest endpoint families, by resource:
Every endpoint follows the same pattern: a verb-named operation on a resource, authenticated with the same header. The per-endpoint reference pages live in Votel's own documentation; this map plus the authentication and format rules above are everything you need to start calling it.
Every plan starts with a 14-day trial. Build your first AI agent in about five minutes — no setup fees, cancel anytime.
You will land on Votel through our affiliate link. If you sign up, we may earn a commission, at no extra cost to you.