Skip to main content

​
Quickstart

Get started with the Truedy API in 5 minutes. This guide will walk you through creating an API key, making your first API call, and creating an agent.

​
Prerequisites

  • A Truedy account (Sign up)
  • An API key (created below)
  • cURL, Python, or JavaScript installed

​
Step 1: Create an API Key

First, create an API key through the dashboard or API: 
curl -X POST https://api.truedy.ai/api/public/v1/auth/api-keys \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "key_name": "My First API Key"
  }'
Save the API key - you’ll need it for all requests!

​
Step 2: List Your Agents

Let’s make your first API call to list your agents: 
curl https://api.truedy.ai/api/public/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Step 3: Create an Agent

Now let’s create your first 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": "Customer Support Agent",
    "description": "Helps customers with support questions",
    "voice_id": "VOICE_UUID",
    "system_prompt": "You are a helpful customer support agent. Be friendly and professional.",
    "model": "ultravox-v0.6"
  }'

​
Step 4: Make a Call

Make your first call with the 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"
  }'

​
Next Steps

Explore Endpoints

Check out the API Reference for all available endpoints

Read Guides

Learn more in our Guides section

Check Rate Limits

Understand Rate Limits and usage tracking

Set Up Webhooks

Configure Webhooks for real-time events

​
Common Issues

​
Invalid API Key

Make sure you’re using the correct API key and it’s in the Authorization: Bearer <key> header.

​
Rate Limit Exceeded

Check the rate limit headers in the response. You may need to upgrade your plan or wait for the limit to reset.

​
Missing Voice ID

Before creating an agent, you need to create or import a voice. See the Voices API Reference.

​
Need Help?