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

# Quick Start

> Get started with the Sawt API in minutes

# Getting Started with Sawt API

This guide will help you quickly integrate the Sawt AI voice assistant into your applications.

## Step 1: Get your API key

<Steps>
  <Step title="Create an account">
    Sign up for a Sawt account at [app.sawt.sa](https://app.sawt.sa)
  </Step>

  <Step title="Create an agent">
    Navigate to the Agents section and create a new voice agent
  </Step>

  <Step title="Get your API key">
    Go to API Keys section and generate a new key
  </Step>
</Steps>

## Step 2: Make your first call

### Using cURL

```bash theme={null}
curl -X POST "https://app.sawt.sa/api/v1/calls/outbound" \
  -H "Authorization: Bearer YOUR_SAWT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "966501234567",
    "agentId": "YOUR_AGENT_ID",
    "promptVariables": {
      "customer_name": "Mohammed"
    }
  }'
```

### Using JavaScript

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

async function makeCall() {
  try {
    const response = await axios.post(
      "https://app.sawt.sa/api/v1/calls/outbound",
      {
        phoneNumber: "966501234567",
        agentId: "YOUR_AGENT_ID",
        promptVariables: {
          customer_name: "Mohammed",
        },
      },
      {
        headers: {
          Authorization: "Bearer YOUR_SAWT_API_KEY",
          "Content-Type": "application/json",
        },
      }
    );

    console.log("Call initiated:", response.data);
  } catch (error) {
    console.error(
      "Error:",
      error.response ? error.response.data : error.message
    );
  }
}

makeCall();
```

## Step 3: Explore more features

<CardGroup cols={2}>
  <Card title="Phone Calls" icon="phone" href="/api-reference/endpoint/create-phone-call">
    Make outbound phone calls with AI agents
  </Card>

  <Card title="Web Calls" icon="globe" href="/api-reference/endpoint/web-calls">
    Embed voice AI in your website or app
  </Card>

  <Card title="Speech-to-Text" icon="microphone" href="/api-reference/endpoint/stt">
    Convert speech from audio files to text
  </Card>

  <Card title="Text-to-Speech" icon="volume-high" href="/api-reference/endpoint/tts">
    Generate speech from text with streaming response
  </Card>
</CardGroup>

## Need help?

<Card title="Contact Support" icon="headset" href="mailto:founders@sawt.sa">
  Our team is ready to help you with any questions or issues
</Card>