REST API · WebSockets · SDKs

Integrate AI voice
calls into
your app.

Make real calls from your code with just a few requests. Voxefy handles telephony, voice models and the conversation. You just connect.

SDKs: Node.js Python REST Webhooks
voxefy-demo.js Node.js
// 1. Install the SDK
// npm install voxefy

import Voxefy from 'voxefy';

const client = new Voxefy('vxf_sk_••••••••');

// 2. Launch a call
const call = await client.calls.create({
  to:       '+1 300 000 0000',
  agent:    'agent_luisa',
  language: 'es',
});

console.log(call.status); // 'initiated'
What the API offers

Everything you need
to build.

REST API

Simple by design

Create agents, launch calls and query results with standard HTTP requests. No weird libraries, no complex setup.

Webhooks

Real-time events

Receive instant notifications when the customer responds, when an appointment is scheduled or when the call ends. React in real time.

Transcriptions

Every word, saved

Access the full transcript of every call, with timestamps and speaker separation. Perfect for analyzing conversations.

SDKs

Node.js & Python

Official SDKs with full typing so your IDE helps you. Or use the API directly if you prefer total control.

Quickstart

Three steps.
First call.

01

Install and authenticate

Get your API key from the dashboard and add it as an environment variable.

02

Create your agent

Define how it talks, what language it uses and what it should say to your customers.

03

Launch the call

A single request to start the call. Receive the result via webhook.

quickstart.js Node.js
# Install the Node.js SDK
npm install voxefy

# Or use the API directly with curl
curl https://api.voxefy.io/v1/agents \
  -H "Authorization: Bearer vxf_sk_..."

const agent = await client.agents.create({
  name:     'Luisa',
  language: 'es',
  voice:    'es-female-natural',
  prompt:   'Sales advisor for...',
});

console.log(agent.id); // 'agent_abc123'

const call = await client.calls.create({
  to:    '+1 300 000 0000',
  agent: 'agent_abc123',
});

// Receive events via webhook
// POST https://your-app.com/webhook
{
  "event": "call.completed",
  "outcome": "appointment_scheduled"
}
API Reference

Main
endpoints.

POST
/v1/calls

Start a voice call to a number. Specify the agent, language and destination number. Returns the call ID and status.

GET
/v1/calls/:id

Query the current status of a call: initiated, in progress, completed or failed. Includes duration and outcome.

POST
/v1/agents

Create a voice agent with a name, language, voice and custom prompt. You can have multiple agents for different use cases.

GET
/v1/transcripts/:id

Get the full transcript of a call, with timestamps per turn and separation between agent and customer.

POST
/v1/campaigns

Create a mass campaign with a list of numbers. Voxefy manages the calls in parallel and reports the result of each one.

GET
/v1/analytics

Aggregated metrics for your calls: response rate, average duration, results by campaign and conversion by agent.

Start building

Your first call
in minutes.

Get your free API key, follow the quickstart and make your first AI voice call from your own code today.

Get free API key → See endpoints