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

# Developer Quickstart

> Get started with the Hamsa API in 5 minutes

Get up and running with the Hamsa API quickly. This guide walks you through making your first API call and creating a voice agent programmatically.

## Prerequisites

* Hamsa account ([Sign up](https://agents.tryhamsa.com))
* API key ([Create one](/overview/create-api-keys))
* Basic knowledge of REST APIs
* cURL, Postman, or your preferred HTTP client

## Step 1: Get Your API Key

1. Log in to your Hamsa dashboard
2. Navigate to **Settings** → **API Keys**
3. Click **Create API Key**
4. Copy and save your key securely

<Warning>
  Keep your API key secure. Never commit it to version control or share it publicly.
</Warning>

## Step 2: Make Your First API Call

Test your API key with a simple request:

```bash theme={null}
curl -X GET https://api.tryhamsa.com/v1/voice-agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

You should receive a list of your voice agents (empty if you haven't created any yet).

## Step 3: Create a Voice Agent

Create your first agent via the API:

```bash theme={null}
curl -X POST https://api.tryhamsa.com/v1/voice-agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Agent",
    "type": "SINGLE_PROMPT",
    "prompt": "You are a helpful customer service agent. Answer questions politely and professionally.",
    "projectId": "YOUR_PROJECT_ID"
  }'
```

## Next Steps

<CardGroup cols={2}>
  <Card title="API Integration" href="/developers/guides/api-integration">
    Learn about working with agents via API
  </Card>

  <Card title="Webhook Integration" href="/developers/guides/webhook-integration">
    Set up webhooks to receive call events
  </Card>

  <Card title="Tools API" href="/developers/guides/tools-api">
    Create tools programmatically
  </Card>

  <Card title="API Reference" href="/api-reference/introduction">
    Complete API documentation
  </Card>
</CardGroup>