QUICK START GUIDE

Build Your First AI Voice Agent in 5 Minutes

Get up and running with VoxPria API — from API key generation to your first AI-powered phone call. No complex setup, no lengthy onboarding.

5 Min

Total Setup Time

3

Simple Steps

$10

Free Credit Included

REST

API Style

Step 1: Generate Your API Key

Your API key authenticates all requests to VoxPria

1. Log in to your VoxPria dashboard

2. Navigate to Settings → Developer tab

3. Click “Create New API Key”

4. Name your key (e.g., “Production API”)

5. Select scopes (permissions) for the key

6. Copy and securely store your key


Your API Key Format

vpk_live_abc123xyz789def456ghi012jkl345

Keys starting with vpk_test_ are for testing. Use vpk_live_ for production.

Step 2: Make Your First API Call

Test your connection with a simple call to trigger an AI voice agent

🐚 Using cURL

curl -X POST "https://api.voxpria.com/api/v1/calls" \
  -H "Authorization: Bearer vpk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "+14155551234",
    "agentId": "agent_abc123",
    "engine": "elevenlabs"
  }'

🧩 Using C#

using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer vpk_live_YOUR_API_KEY");

var payload = new {
    phoneNumber = "+14155551234",
    agentId = "agent_abc123",
    engine = "elevenlabs"
};

var json = JsonSerializer.Serialize(payload);

var response = await client.PostAsync(
    "https://api.voxpria.com/api/v1/calls",
    new StringContent(json, Encoding.UTF8, "application/json")
);

var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);

🐘 Using PHP


 "+14155551234",
    "agentId" => "agent_abc123",
    "engine" => "elevenlabs"
];

$ch = curl_init("https://api.voxpria.com/api/v1/calls");

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer vpk_live_YOUR_API_KEY",
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

🐍 Using Python

import requests

url = "https://api.voxpria.com/api/v1/calls"
headers = {
    "Authorization": "Bearer vpk_live_YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "phoneNumber": "+14155551234",
    "agentId": "agent_abc123",
    "engine": "elevenlabs"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

📦 Using Node.js

const fetch = require('node-fetch');

const response = await fetch('https://api.voxpria.com/api/v1/calls', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer vpk_live_YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phoneNumber: '+14155551234',
    agentId: 'agent_abc123',
    engine: 'elevenlabs'
  })
});

const call = await response.json();
console.log(call);

Step 3: Handle the Response

VoxPria returns a JSON response with call details and status

Success Response (200 OK)

{
  "success": true,
  "data": {
    "id": "call_abc123xyz",
    "phoneNumber": "+14155551234",
    "agentId": "agent_abc123",
    "status": "initiated",
    "engine": "elevenlabs",
    "createdAt": "2026-02-02T14:30:00Z"
  }
}

Call Status Values:

  • initiated – Call is being dialed
  • in_progress – Call is active
  • completed – Call ended
  • failed – Call failed

🎯 What’s Next?

Now that you’ve made your first call, explore these resources

API Reference

Explore all endpoints, parameters, and response formats

Webhooks Guide

Receive real-time notifications when calls complete

Build AI Agents

Create custom conversation flows with our visual builder

Ready to Build Something Amazing?

Start building AI-powered voice applications with $10 in free credits

REST API
5-Min Setup
Enterprise Security
190+ Countries

🎉 $10 free credit • No credit card required • Full API access