Build on Vocenya
Pull calls, leads, bookings and chats into your own tools, queue compliant AI callbacks, get signed webhooks the moment something happens, and connect AI assistants over MCP.
curl https://vocenya.com/api/public/v1/me \
-H "Authorization: Bearer $VOCENYA_API_KEY"Base URL https://vocenya.com/api/public/v1
Guides
- QuickstartCreate an API key and make your first request to the Vocenya API in a few minutes.
- Authentication and scopesAuthenticate every request with an organization API key sent as a Bearer token, and give each key only the scopes it needs.
- Test modeBuild and test against a separate set of test data with vk_test_ keys. Test calls never ring anyone.
- PaginationEvery list endpoint is newest first and cursor paginated. Pass meta.next_cursor back as cursor to walk through the pages.
- ErrorsThe Vocenya API uses standard HTTP status codes and one JSON error shape, with a machine-readable code for every refusal you can act on.
- Rate limitsEach API key can make a set number of requests a minute, shared between the REST API and the platform MCP server. Past it, wait for Retry-After.
- Outbound calls and complianceQueue AI calls through the API. Every call is checked against consent, Do Not Call lists, calling hours and daily limits before it can ring.
- ChangelogEvery change to the Vocenya API, webhooks and MCP servers, newest first, with the date it shipped.
API reference
- OverviewEvery endpoint of the Vocenya REST API, grouped by resource.
- AccountThe account and key behind the request.
- CallsPhone calls your AI receptionist, GH Live agents and team handled.
- LeadsPeople who called, chatted or filled in a form.
- BookingsAppointments the AI booked into your calendar or field-service software.
- Outbound callsHave the AI call someone who agreed to AI calls.
- Do Not CallNumbers your AI never calls.
- Blocked callersNumbers and prefixes whose inbound calls are turned away before your receptionist answers (spam, robocallers).
- ChatsChats on your website widget (channel: web) and on WhatsApp (channel: whatsapp, with the customer's number in contact_address).
- WebhooksGet events pushed to your HTTPS endpoint instead of polling.