Skip to main content

​
Making Your First Call

This guide walks you through making your first 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 a call with your agent: 
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": "+1234567890",
    "direction": "outbound",
    "context": {
      "first_name": "Jane",
      "company": "Acme Inc"
    },
    "call_settings": {
      "recording_enabled": true,
      "transcription_enabled": true
    }
  }'

​
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