API Reference

The Telezen API allows you to programmatically manage your agency, clients, and AI voice agents. By integrating with our API, you can automate workflows, sync data with your CRM, and build custom experiences on top of the Telezen platform.

Getting Your API Key

To authenticate your requests, you need a Telezen API key.

1. Log in to your Telezen Dashboard as an agency administrator.
2. Navigate to Settings > Organization > Developers > API Keys.
3. Click on Generate New API Key.
4. Provide a descriptive name for your key (e.g., "Zapier Integration").
5. Copy the generated key immediately. For security reasons, you will not be able to see it again.

Send the raw key value in the X-API-Key header of each request (not a Bearer token and not the Authorization header):

X-API-Key: YOUR_API_KEY

Available Functions

The Telezen API provides a range of endpoints to manage your agency operations.

Organization

GET /organization Retrieve details about your agency configuration, including your organization's name, address, phone, email, and website.

Clients

POST /clients Create a new client account with portal access. Returns the created client ID.

Request Body:

• record (string): Type of client record, either person or company.
• name (string): Full name of the client.
• email (string): Email address for portal access.
• phone (string, optional): Phone number.
• password (string): Password for portal access. Must contain at least 8 characters, one uppercase letter, one lowercase letter, one number, and one special character.

Agents

POST /clients/{clientId}/agents Assigns a VAPI AI agent to a specific client and configures the webhook for usage tracking.

Path Parameters:

• clientId (string): The UUID of the client.

Request Body:

• vapiAgentId (string): The VAPI agent ID to assign to the client.

Note: This automatically configures the VAPI agent with a webhook URL for usage tracking and server messages for end-of-call reports.

For full technical specifications, request and response schemas, and interactive API exploration, please refer to our dedicated API developer portal.