Skip to main content

​
Base URL

All API requests should be made to: 
https://api.callgency.com

​
Authentication

All API endpoints are authenticated using an Authorization header with your API key. Note that you should pass the API key directly without the ‘Bearer’ prefix. 
Authorization: your-api-key-here

​
API Key Types

There are two types of API keys:
  • Company API Key: Used for company-level operations including:
    • Agent management (agents, files, integrations, tools)
    • Module instances
    • Contacts and conversations
    • Call logs, chat logs, and transcripts
    • Company settings, staff, and phone numbers
  • Agency API Key: Required for all agency-level operations (/agency/* endpoints) including:
    • Agency settings management
    • Managing companies under your agency
    • Agency admin invitations
    • Agency phone number management
You can find your API keys in your dashboard settings. Make sure to use the correct API key type for the endpoints you’re accessing.

​
Example Request

curl -X GET https://api.callgency.com/agent/list \
  -H "Authorization: your-company-api-key-here" \
  -H "Content-Type: application/json"

curl -X GET https://api.callgency.com/agency \
  -H "Authorization: your-agency-api-key-here" \
  -H "Content-Type: application/json"

​
API Endpoints

The Callgency AI API is organized into the following categories:

​
Agent Management

Create, manage, and configure AI agents (chatbots and voicebots) for your platform.

​
Contacts

Manage contacts and their information across your agents and conversations.

​
Conversations

Access conversation history, transcripts, and chat logs from your AI agents.

​
Module Instances

Configure and manage module instances for advanced agent capabilities.

​
Settings

Manage company settings, staff, and system configurations.

​
Agency Management

Manage your agency account, companies, and agency-level settings.

​
Rate Limits

API requests are rate-limited to ensure fair usage. Current limits:
  • Starter: 100 requests per minute
  • Growth: 1,000 requests per minute
  • Enterprise: Custom limits available

​
Support

Need help? Contact our support team at [email protected]