Skip to main content

​
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
  2. Navigate to Account → API Tokens
  3. Copy your API token

​
Using Your Token

Include the token in the Authorization header: 
curl -X GET https://api.meetzy.io/calls \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
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

CodeDescription
200Success
201Created
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing token
403Forbidden - Insufficient permissions
404Not Found - Resource doesn’t exist
429Too Many Requests - Rate limited
500Internal 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'
  }
});

​
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.