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

# Quickstart

> Learn how to make your first ThreeTone API request

The ThreeTone API provides a simple interface to production voice AI
capabilities. Follow this guide to authenticate, create your first agent, and
verify the response shape that downstream integrations should expect.

## Authentication

All API requests require authentication using an API key in the `x-api-key` header.

### Get your API key

1. **Create an account**: Sign in through the [ThreeTone dashboard](https://threetone.in/app/voice-ai)
2. **Generate API key**: Navigate to Settings → API Keys and create a new key
3. **Store securely**: Save your API key securely - it will only be shown once

## Using the Voice Agents API

### Create your first agent

```bash cURL theme={null}
curl --request POST \
  --url https://api.threetone.in/v1/convai/agents/create \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Customer Support Agent",
    "system_prompt": "You are a helpful customer support representative."
  }'
```

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

url = "https://api.threetone.in/v1/convai/agents/create"
headers = {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "name": "Customer Support Agent",
    "system_prompt": "You are a helpful customer support representative."
}

response = requests.post(url, headers=headers, json=data)
agent = response.json()
print(f"Created agent: {agent['agent_id']}")
```

```javascript JavaScript theme={null}
const response = await fetch("https://api.threetone.in/v1/convai/agents/create", {
  method: "POST",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Customer Support Agent",
    system_prompt: "You are a helpful customer support representative.",
  }),
});

const agent = await response.json();
console.log(`Created agent: ${agent.agent_id}`);
```

### Response

```json theme={null}
{
  "agent_id": "agent_abc123xyz",
  "name": "Customer Support Agent",
  "created_at_unix": 1713528000
}
```

## Next steps

### Explore our developer guides

<CardGroup cols={2}>
  <Card title="Creating Voice Agents" href="/guides/voice-agents/creating-agents">
    Learn advanced agent configuration and customization
  </Card>

  <Card title="Knowledge Base Integration" href="/guides/knowledge-base/uploading-documents">
    Add context and intelligence to your agents
  </Card>

  <Card title="Phone Integration" href="/guides/phone-integration/setup">
    Connect agents to phone systems
  </Card>

  <Card title="Conversation Management" href="/guides/voice-agents/managing-conversations">
    Monitor and analyze agent conversations
  </Card>
</CardGroup>

### Additional resources

* **[API Reference](/api-reference/introduction)**: Complete API documentation
* **[Authentication Guide](/guides/authentication)**: Detailed authentication setup
* **[Voice AI Capabilities](/capabilities/voice-agents)**: Platform overview

## Security best practices

* Always use HTTPS endpoints for API requests
* Store API keys securely using environment variables
* Never commit API keys to version control
* Rotate API keys regularly for enhanced security