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

# Introduction

> Explore our API Reference to integrate Meetzy with your systems.

## Welcome to the Meetzy API

The Meetzy API allows you to programmatically trigger calls, retrieve call data, and integrate AI-powered voice agents with your existing systems.

## Base URL

All API requests are made to:

```
https://api.meetzy.io
```

## Authentication

All API requests require authentication using a Bearer token.

### Getting Your API Token

1. Log in to your [Meetzy Dashboard](https://dashboard.meetzy.io)
2. Navigate to **Account** → **API Tokens**
3. Copy your API token

### Using Your Token

Include the token in the `Authorization` header:

```bash theme={null}
curl -X GET https://api.meetzy.io/calls \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
```

<Warning>
  Keep your API token secret. Never expose it in client-side code or public repositories.
</Warning>

## Request Format

All requests should include the `Content-Type: application/json` header when sending data.

```json theme={null}
{
  "phone": "+1234567890",
  "playbook_id": "pb_abc123",
  "params": {
    "customer_name": "John Doe"
  }
}
```

## Response Format

All responses are returned in JSON format:

```json theme={null}
{
  "success": true,
  "data": {
    "call_id": "call_xyz789",
    "status": "initiated"
  }
}
```

### Error Responses

Errors include an error code and message:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "invalid_phone",
    "message": "The provided phone number is invalid"
  }
}
```

## HTTP Status Codes

| Code | Description                             |
| ---- | --------------------------------------- |
| 200  | Success                                 |
| 201  | Created                                 |
| 400  | Bad Request - Invalid parameters        |
| 401  | Unauthorized - Invalid or missing token |
| 403  | Forbidden - Insufficient permissions    |
| 404  | Not Found - Resource doesn't exist      |
| 429  | Too Many Requests - Rate limited        |
| 500  | Internal Server Error                   |

## Rate Limiting

API requests are rate limited to ensure fair usage:

* **Standard**: 100 requests per minute
* **Burst**: 10 requests per second

When rate limited, you'll receive a `429` response with retry information.

## SDKs and Libraries

Official SDKs coming soon. In the meantime, use any HTTP client:

<CodeGroup>
  ```javascript Node.js (axios) theme={null}
  const axios = require('axios');

  const client = axios.create({
    baseURL: 'https://api.meetzy.io',
    headers: {
      'Authorization': `Bearer ${process.env.MEETZY_API_TOKEN}`,
      'Content-Type': 'application/json'
    }
  });
  ```

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

  headers = {
      'Authorization': f'Bearer {API_TOKEN}',
      'Content-Type': 'application/json'
  }

  response = requests.get(
      'https://api.meetzy.io/calls',
      headers=headers
  )
  ```
</CodeGroup>

## Need Help?

<CardGroup cols={2}>
  <Card title="Create a Call" icon="phone" href="/api-reference/endpoint/create">
    Learn how to initiate calls via API.
  </Card>

  <Card title="Create a Campaign" icon="megaphone" href="/api-reference/endpoint/campaign">
    Launch outbound call campaigns from a contact list.
  </Card>

  <Card title="Get Call Details" icon="info-circle" href="/api-reference/endpoint/get">
    Retrieve detailed call information.
  </Card>

  <Card title="List Calls" icon="list" href="/api-reference/endpoint/list">
    Retrieve your call history.
  </Card>

  <Card title="Support" icon="life-ring" href="mailto:support@meetzy.io">
    Contact our support team.
  </Card>
</CardGroup>