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:
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 -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.
Content-Type: application/json header when sending data.
{
"phone": "+1234567890",
"playbook_id": "pb_abc123",
"params": {
"customer_name": "John Doe"
}
}
{
"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'
}
});
Need Help?
