Skip to main content

​
Quick Start

Get up and running with the Vocobase Partner API. By the end of this guide, you will have created a voice agent and initiated your first outbound call.

​
Prerequisites

  • A Vocobase account with approved partner status (apply here)
  • Your API key (format: rg_live_xxxx)
  • At least one telephony provider configured (Twilio or MCube)
1

Get your API key

Log in to the Vocobase Dashboard and navigate to API Keys. Create a new key and copy it immediately — it is only shown once.Your key looks like this:
rg_live_abc123def456ghi789jkl012
Store your API key securely. It cannot be retrieved after creation.
2

Test your connection

Verify your API key works by fetching your partner configuration:
curl -X GET https://api.vocobase.com/api/v2/config \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012"
You should receive a response with your partner configuration:
{
  "success": true,
  "data": {
    "name": "acme-corp",
    "display_name": "Acme Corporation",
    "agent_limit": 10,
    "current_agent_count": 0,
    "status": "active",
    ...
  }
}
3

Create an agent

Create your first voice agent. You will need a voice_id from the available voices list — fetch it first with GET /agent/voices.
curl -X POST https://api.vocobase.com/api/v2/agent \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "Sales Assistant",
    "prompt": "You are a friendly sales assistant for Acme Corp. Help callers understand our products and answer their questions.",
    "voice_id": "a0e99841-438c-4a64-b679-ae501e7d6091",
    "language": "en",
    "agent_type": "outbound",
    "intro_message": "Hello! Thanks for taking my call. How can I help you today?"
  }'
The response includes your new agent’s ID:
{
  "success": true,
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "agent_name": "Sales Assistant",
    "status": "active",
    ...
  }
}
Save the id from the response — you will need it to start calls.
4

Make your first call

Initiate an outbound call using the agent you just created. Replace the agent_id with the ID from the previous step.
curl -X POST https://api.vocobase.com/api/v2/calls/start \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "to_number": "+919876543210",
    "provider": "twilio"
  }'

{
  "success": true,
  "data": {
    "call_id": "c1234567-abcd-1234-abcd-123456789012",
    "session_id": "s1234567-abcd-1234-abcd-123456789012",
    "status": "pending",
    "provider": "twilio",
    "from_number": "+14155551234",
    "to_number": "+919876543210",
    "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}
The call is placed asynchronously. Set up webhooks to receive a notification when the call completes, including the full transcript and latency metrics.

​
Next steps

Authentication

Learn about API key formats, rate limits, and error handling.

Configure Webhooks

Receive real-time notifications when calls complete.

Twilio Setup

Configure Twilio for outbound calling.

API Reference

Explore the full API reference.