Skip to main content

​
Making Your First Call

This guide walks you through making your first outbound voice call using the Truedy API.

​
Prerequisites

​
Step 1: Create an Agent

First, create a voice agent: 
curl -X POST https://api.truedy.ai/api/public/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Agent",
    "voice_id": "VOICE_UUID",
    "system_prompt": "You are a helpful support agent.",
    "model": "ultravox-v0.6"
  }'

​
Step 2: Make a Call

Now make an outbound call with your agent. Only agent_id and phone_number are required — the system auto-selects a from number from your agent’s assigned outbound numbers: 
curl -X POST https://api.truedy.ai/api/public/v1/calls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "AGENT_UUID",
    "phone_number": "+15551234567",
    "variables": {
      "first_name": "Jane",
      "company": "Acme Inc"
    }
  }'
If you want to choose a specific from number, add from_number: 
{
  "agent_id": "AGENT_UUID",
  "phone_number": "+15551234567",
  "from_number": "+15559998888"
}

​
Step 3: Check Call Status

Monitor the call status: 
curl https://api.truedy.ai/api/public/v1/calls/CALL_UUID \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Step 4: Get Call Transcript

After the call completes, get the transcript: 
curl https://api.truedy.ai/api/public/v1/calls/CALL_UUID/transcript \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Next Steps