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

# Quickstart

> Get started with the Voice Agent API in minutes

## Get Started in 3 Steps

Get up and running with the Voice Agent API quickly.

### Step 1: Get Your API Key

<AccordionGroup>
  <Accordion icon="key" title="Create an API Key">
    To authenticate your requests, you'll need an API key:

    1. Log in to your dashboard
    2. Navigate to API Keys section
    3. Click "Create API Key"
    4. Give it a descriptive name
    5. Copy the key value (you won't be able to see it again!)

    <Warning>Store your API key securely. It provides full access to your account.</Warning>
  </Accordion>

  <Accordion icon="lock" title="Alternative: JWT Authentication">
    If you're building a web application, you can use JWT token authentication instead:

    1. Authenticate users through your application
    2. Receive a JWT token
    3. Include it in the `Authorization: Bearer <token>` header
  </Accordion>
</AccordionGroup>

### Step 2: Make Your First Request

<AccordionGroup>
  <Accordion icon="code" title="List Your Agents">
    Try listing your agents to verify your authentication works:

    ```bash theme={null}
    curl -X GET "https://api.example.com/api/v1/agents" \
      -H "X-API-Key: your-api-key-here"
    ```

    Or with JWT:

    ```bash theme={null}
    curl -X GET "https://api.example.com/api/v1/agents" \
      -H "Authorization: Bearer your-jwt-token"
    ```
  </Accordion>

  <Accordion icon="robot" title="Create Your First Agent">
    Create a new voice agent:

    ```bash theme={null}
    curl -X POST "https://api.example.com/api/v1/agents" \
      -H "X-API-Key: your-api-key-here" \
      -H "Content-Type: application/json" \
      -d '{
        "agent": {
          "name": "My First Agent",
          "conversation_config": {}
        }
      }'
    ```
  </Accordion>
</AccordionGroup>

### Step 3: Explore the API

<Accordion icon="rocket" title="Next Steps">
  Now that you've made your first API call, explore what you can build:

  * **Create Integrations**: Set up third-party service connections
  * **Manage Conversations**: Access conversation data and transcripts
  * **Create Campaigns**: Build voice campaigns for bulk outreach
  * **Configure Agents**: Customize agent behavior and tools
</Accordion>

## API Endpoints

<CardGroup cols={2}>
  <Card title="Agents" icon="robot" href="/api-reference/agents/overview">
    Create and manage voice agents
  </Card>

  <Card title="Integrations" icon="plug" href="/api-reference/integrations/overview">
    Configure service integrations
  </Card>

  <Card title="API Keys" icon="key" href="/api-reference/api-keys/overview">
    Manage authentication keys
  </Card>

  <Card title="Conversations" icon="comments" href="/api-reference/conversations/overview">
    Access conversation data
  </Card>

  <Card title="Campaigns" icon="bullhorn" href="/api-reference/campaigns/overview">
    Create voice campaigns
  </Card>
</CardGroup>

## Code Examples

### JavaScript/Node.js

```javascript theme={null}
const axios = require('axios');

const apiClient = axios.create({
  baseURL: 'https://api.example.com/api/v1',
  headers: {
    'X-API-Key': 'your-api-key-here'
  }
});

// List agents
const agents = await apiClient.get('/agents');

// Create an agent
const newAgent = await apiClient.post('/agents', {
  agent: {
    name: 'My Voice Agent',
    conversation_config: {}
  }
});
```

### Python

```python theme={null}
import requests

headers = {
    'X-API-Key': 'your-api-key-here',
    'Content-Type': 'application/json'
}

# List agents
response = requests.get(
    'https://api.example.com/api/v1/agents',
    headers=headers
)
agents = response.json()

# Create an agent
agent_data = {
    'agent': {
        'name': 'My Voice Agent',
        'conversation_config': {}
    }
}
response = requests.post(
    'https://api.example.com/api/v1/agents',
    headers=headers,
    json=agent_data
)
```

## Need Help?

<CardGroup cols={2}>
  <Card title="API Reference" icon="book" href="/api-reference/introduction">
    Complete API documentation
  </Card>

  <Card title="Support" icon="envelope" href="mailto:support@example.com">
    Contact our support team
  </Card>
</CardGroup>