Skip to main content

​
API Tokens

API tokens allow you to authenticate with the Meetzy API for programmatic access to your account. Use tokens to integrate Meetzy with your systems, trigger calls, and retrieve data.

​
Accessing API Tokens

Navigate to Account → API Tokens to view and manage your tokens.

​
Token Overview

Your API tokens are listed with:
FieldDescription
NameToken identifier
TokenThe secret key (partially hidden)
Expires InWhen the token will expire

​
Security Guidelines

Keep your API tokens secret!
  • Never share tokens with others
  • Never expose tokens in client-side code
  • Never commit tokens to version control
  • Meetzy may automatically disable leaked tokens

​
Using Your Token

​
Authentication Header

Include your token in the Authorization header: 
curl -X POST https://api.meetzy.io/call \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+1234567890", "playbook_id": "..."}'

​
In Code Examples

const axios = require('axios');

const response = await axios.post('https://api.meetzy.io/call', {
  phone: '+1234567890',
  playbook_id: 'your-playbook-id'
}, {
  headers: {
    'Authorization': `Bearer ${process.env.MEETZY_API_TOKEN}`,
    'Content-Type': 'application/json'
  }
});

​
Copying Your Token

  1. Find the token in your list
  2. Click the Copy button next to the token
  3. Button changes to “Copied!” when successful
  4. Paste the token in your application
Only the first 40 characters are displayed for security. The copy function copies the complete token.

​
Token Expiration

Tokens have an expiration period shown in the “Expires In” column:
StatusMeaning
X daysToken expires in X days
ExpiredToken no longer works
NeverToken doesn’t expire (not recommended)

​
Before Expiration

  1. Generate a new token
  2. Update your applications
  3. Old token continues working until expiration
  4. Test with new token before old one expires

​
Best Practices

Environment Variables

Store tokens in environment variables, never in code.

Rotate Regularly

Generate new tokens periodically for security.

Minimum Permissions

Use tokens only where needed.

Monitor Usage

Track API calls to detect unauthorized access.

​
Environment Variable Setup

export MEETZY_API_TOKEN="your-token-here"

​
Token Permissions

API tokens have full access to your account, including:
  • ✅ Create and manage calls
  • ✅ Access call history and details
  • ✅ Manage agents (playbooks)
  • ✅ Access CRM data
  • ✅ View analytics
Granular permission control is coming soon. Currently, all tokens have full account access.

​
Troubleshooting

ErrorSolution
401 UnauthorizedCheck token is correct and not expired
403 ForbiddenToken may be disabled, contact support
Token not workingEnsure no extra spaces when copying
Rate limitedToo many requests, implement backoff

​
If Your Token is Compromised

  1. Immediately go to API Tokens page
  2. Contact support to disable the token
  3. Generate a new token
  4. Update all applications
  5. Review recent API activity for suspicious calls

​
Creating New Tokens

Token creation is currently managed by Meetzy support. Contact us to request additional tokens.
Future self-service token creation will include:
  • Custom token names
  • Expiration settings
  • Permission scopes
  • Usage limits

​
Next Steps

API Reference

Learn about available API endpoints.

Create a Call

Make your first API call.