Introduction

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

Log in to your Meetzy Dashboard
Navigate to Account → API Tokens
Copy your API token

Using Your Token

Include the token in the Authorization header:

curl -G https://api.meetzy.io/calls \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  --data-urlencode "agent_id=YOUR_AGENT_ID"

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

Request Format

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

{
  "phone": "+1234567890",
  "playbook_id": "pb_abc123",
  "params": {
    "customer_name": "John Doe"
  }
}

Response Format

All responses are returned in JSON format:

{
  "success": true,
  "data": {
    "call_id": "call_xyz789",
    "status": "initiated"
  }
}

Error Responses

Errors include an error code and message:

{
  "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:

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'
  }
});

import requests

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

response = requests.get(
    'https://api.meetzy.io/calls',
    headers=headers,
    params={'agent_id': AGENT_ID}
)

Need Help?

Create a Call

Learn how to initiate calls via API.

Create a Campaign

Launch outbound call campaigns from a contact list.

Get Call Details

Retrieve detailed call information.

List Calls

Retrieve your call history.

Support

Contact our support team.

API Reference

Endpoints

Advanced Features

Welcome to the Meetzy API

Base URL

Authentication

Getting Your API Token

Using Your Token

Request Format

Response Format

Error Responses

HTTP Status Codes

Rate Limiting

SDKs and Libraries

Need Help?

Create a Call

Create a Campaign

Get Call Details

List Calls

Support

​Welcome to the Meetzy API

​Base URL

​Authentication

​Getting Your API Token

​Using Your Token

​Request Format

​Response Format

​Error Responses

​HTTP Status Codes

​Rate Limiting

​SDKs and Libraries

​Need Help?

Create a Call

Create a Campaign

Get Call Details

List Calls

Support

Welcome to the Meetzy API

Base URL

Authentication

Getting Your API Token

Using Your Token

Request Format

Response Format

Error Responses

HTTP Status Codes

Rate Limiting

SDKs and Libraries

Need Help?