> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truedy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Making Your First Call

> Learn how to make your first voice call with the Truedy API

# Making Your First Call

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

## Prerequisites

* An API key (see [Authentication](/authentication))
* An agent created (see [Creating an Agent](/guides/creating-an-agent))
* A phone number configured

## Step 1: Create an Agent

First, create a voice agent:

<CodeGroup>
  ```bash cURL theme={null}
  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"
    }'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.truedy.ai/api/public/v1/agents",
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json"
      },
      json={
          "name": "Support Agent",
          "voice_id": "VOICE_UUID",
          "system_prompt": "You are a helpful support agent.",
          "model": "ultravox-v0.6"
      }
  )

  agent_id = response.json()["data"]["id"]
  ```
</CodeGroup>

## Step 2: Make a Call

Now make a call with your agent:

<CodeGroup>
  ```bash cURL theme={null}
  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
      }
    }'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.truedy.ai/api/public/v1/calls",
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json"
      },
      json={
          "agent_id": "AGENT_UUID",
          "phone_number": "+1234567890",
          "direction": "outbound",
          "context": {"first_name": "Jane", "company": "Acme Inc"},
          "call_settings": {
              "recording_enabled": True,
              "transcription_enabled": True
          }
      }
  )

  call = response.json()["data"]
  print(f"Call ID: {call['id']}")
  ```
</CodeGroup>

## Step 3: Check Call Status

Monitor the call status:

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.truedy.ai/api/public/v1/calls/CALL_UUID \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  response = requests.get(
      f"https://api.truedy.ai/api/public/v1/calls/{call_id}",
      headers={"Authorization": "Bearer YOUR_API_KEY"}
  )

  call_status = response.json()["data"]["status"]
  print(f"Call status: {call_status}")
  ```
</CodeGroup>

## Step 4: Get Call Transcript

After the call completes, get the transcript:

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.truedy.ai/api/public/v1/calls/CALL_UUID/transcript \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  response = requests.get(
      f"https://api.truedy.ai/api/public/v1/calls/{call_id}/transcript",
      headers={"Authorization": "Bearer YOUR_API_KEY"}
  )

  transcript = response.json()["data"]["transcript"]
  print(transcript)
  ```
</CodeGroup>

## Next Steps

* Learn about [Batch Calls](/api-reference/batch-calls) for bulk calling
* Set up [Webhooks](/guides/webhooks) for real-time call events
* Explore [Agent Configuration](/api-reference/agents) for advanced features