¿Prefiere leer esta página en español? ESPAÑOL
VOTEL.CC

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

Votel API

Build with the Votel API to create AI voice agents, send messages, manage contacts, trigger workflows, and retrieve results programmatically. Version 1.0.0.

What the API Covers

The API is organized to match the Votel app, so you can find endpoints for anything you do in the dashboard:

App sectionWhat you can do via the API
ConversationsRead inbox threads, send messages (SMS, email, WhatsApp), manage quick replies, configure channels
CalendarsCreate booking pages, manage availability & staff, accept bookings, handle waitlists
ContactsCreate and search leads, import/export, custom fields, pipeline stages, activity timelines
TasksCreate and assign tasks, custom task fields, saved task views
AgentsBuild and deploy AI voice agents, manage versions, knowledge bases, TTS voices, AI generation
ActivityQuery call logs, meeting logs, phone/widget/workflow reports, messaging logs
WorkflowsCreate automations, set triggers, enroll contacts, manage variables and campaigns
CommunicationSend SMS and emails directly, manage email templates
PaymentsManage billing, products, and subscriptions
Click TrackingCreate tracking links, monitor clicks, conversions, landing pages, and traffic sources
SettingsAPI keys, users, sub-accounts, phone numbers, integrations, domains, and more

Authentication

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.

Base URL

https://app.votel.ai/api

All endpoints are relative to this base URL.

Make Your First Request

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.

Request and Response Format

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" }

Status Codes

CodeMeaning
200Success
201Created
400Bad request — check your parameters
401Unauthorized — invalid or missing API key
402Payment required — insufficient wallet balance
403Forbidden — upgrade required or insufficient permissions
404Not found
429Rate limited — back off and retry
500Server error

Rate Limits

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 Endpoint Map

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.

Ready to build your first agent?

Every plan starts with a 14-day trial. Build your first AI agent in about five minutes — no setup fees, cancel anytime.

Get Started With Votel

You will land on Votel through our affiliate link. If you sign up, we may earn a commission, at no extra cost to you.