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

API keys are created in the Truedy Dashboard only. There is no Public API endpoint for creating or managing API keys.
  1. Log in to the Truedy Dashboard.
  2. Go to Settings → API Keys (or open API Keys directly).
  3. Click Create API Key, give it a name (e.g. “My First API Key”), and copy the key.
The key is shown only once when created. Store it securely. Keys have the format truedy_ followed by a random string (e.g. truedy_Z21gJO4PDlOBbWSWdfSpO72guWIE6KWP). Save the API key — you’ll need it for all requests in the next steps.

​
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?