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.
- Texting (SMS)Texting prices, registering for texting, what Vocenya texts automatically, replies in your inbox, opt-outs, HIPAA limits, and the SMS webhooks and API.
- 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), on WhatsApp (channel: whatsapp) and by text message (channel: sms), the last two with the customer's number in contact_address.
- WebhooksGet events pushed to your HTTPS endpoint instead of polling.
Webhooks
Live chat
MCP
Integrations
- HubSpot and SalesforceSend every caller to HubSpot or Salesforce, log each call and booking on their record, and let your receptionist recognize returning customers.
- Zapier, Make and PipedreamConnect Vocenya to thousands of apps without code: instant triggers for leads, calls, bookings and chats, and actions for leads, AI calls and blocking.
- Calendly and Cal.comLet your receptionist offer the open times of your Calendly or Cal.com event types and book callers straight in.
- SlackPost new leads, missed calls, chats waiting for your team, bookings and messages to a Slack channel, with a link to each one in Vocenya.
- NotionAdd a row to a Notion database for every new lead, completed call and booking, filling the columns you choose.
- Google Business ProfileFill your receptionist from your Google listing in one step, then keep its hours, holiday hours and details in step with your Google Business Profile.