Skip to content
AI Employee

Voice AI Public APIs

Learn how to authenticate, configure agents and actions, retrieve call log(s), and stream events with webhooks using GHL Customer Care's Voice AI Public APIs. Explore GHL Customer Care Voice AI Public APIs to manage agents, retrieve call data, and browse voices with new

4 min read810 words3 explained images
View as markdownOpen in ClaudeOpen in ChatGPT
Each image has a one line explanation. Switch to full detail for the step it belongs to, the fields and buttons involved, examples and the whole procedure.
On this page
  1. Key Benefits of Voice AI Public APIs
  2. Voice AI API Documentation
  3. Voices (Catalog APIs)
  4. Call Log APIs
  5. Agents APIs
  6. Actions APIs
  7. Frequently Asked Questions
  8. Related Articles

GHL Customer Care offers Voice AI Public APIs so you can programmatically manage agents and actions, retrieve call logs and transcripts, and connect real‑time webhooks to your workflows. This article gives a high‑level overview and links to the official API documentation for technical details.


TABLE OF CONTENTS


What are Voice AI Public APIs?

The Voice AI Public APIs give you direct access to configure agents, manage actions, retrieve call data, and integrate web-hooks into your workflows. This elevates Voice AI from a product feature to an extensible capability that can be integrated directly into your workflows and applications.

Instead of limiting Voice AI to in-app controls, you can:

  • Manage Agents & Actions: Create, update, and organize agents and their behaviors via API.
  • Retrieve Call Data: Access logs and transcripts for reporting, compliance, or analytics.
  • Leverage Webhooks: Receive real-time call outcomes, transcripts, and summaries in your own systems.

Link to API Documentation


Key Benefits of Voice AI Public APIs

  • Data Access: Pull call outcomes, transcripts, and metrics for detailing tracking and reporting
  • Workflow Integration: Automate setup and tailor Voice AI to fit your applications and operational needs
  • Extensibility Public APIs make Voice AI not just usable, but buildable

Voice AI API Documentation

API Documentation for Voice AI Public APIs includes details on Call Logs, Agents and Actions. Access requirements, environments, and auth details may evolve. Always refer to the API docs for the latest details.
Click here to access Voice AI API Documentation


Voices (Catalog APIs)

You can now browse the Voice AI catalog using public APIs:

Get Voices: Retrieve a paginated, filterable list of voices. You can filter by language and optionally pass an `agentId` to return only compatible voices.
 

Fetch Voice Details: Retrieve detailed metadata for a specific voice, including a preview URL for testing.  

For full technical details, refer to the Voice AI API documentation in the Developer Portal.


Call Log APIs

Call Log APIs provide access to calls handled by Voice AI; supporting analytics, quality reviews, and compliance. Use it to list calls with filters or fetch individual call details, including transcripts when available. See API Reference docs for additional details.

  • List Call Logs: Returns call logs for Voice AI agents scoped to a location. Supports filtering by agent, contact, call type, action types, and date range (interpreted in the provided IANA timezone). Also supports sorting and 1-based pagination.
  • Get Call Log: Returns a call log by call ID

Click here to access Voice AI API Documentation on Call Logs

Call Log APIs (image 1 of 3) What this shows Click here to access Voice AI API Documentation on Call Logs What this shows Illustrates the "Call Log APIs" section of "Voice AI Public APIs". This screenshot appears in the "Call Log APIs" section of "Voice AI Public APIs". The text alongside this image reads: Click here to access Voice AI API Documentation on Call Logs. This part of the guide covers 1 field, listed below. Immediately after, the guide continues: The Agents APIs lets you programmatically create, list, read, update, and delete Voice AI agents so you can roll out consistent configurations across locations and environments. See API Reference docs for additional details. Image 1 of 3 What to clickClick here to access Voice AI API Documentation on Call Logs
Fields in this part of the guide Get Call Log: Returns a call log by call ID
Next stepThe Agents APIs lets you programmatically create, list, read, update, and delete Voice AI agents so you can roll out consistent configurations across locations and environments. See API Reference docs for additional details.
All 2 steps in this procedure
  1. List Call Logs: Returns call logs for Voice AI agents scoped to a location. Supports filtering by agent, contact, call type, action types, and date range (interpreted in the provided IANA timezone). Also supports sorting and 1-based pagination.
  2. Get Call Log: Returns a call log by call ID

Agents APIs

The Agents APIs lets you programmatically create, list, read, update, and delete Voice AI agents so you can roll out consistent configurations across locations and environments. See API Reference docs for additional details.

  • Create Agent: Create a new Voice AI agent configuration and settings

  • Patch Agent: Partially update an existing Voice AI agent

  • List Agents: Retrieve a paginated list of agents for given location

  • Get Agent: Retrieve detailed configuration and settings for a specific Voice AI agent

  • Delete Agent: Delete a Voice AI agent and all its configurations

Click here to access Voice AI API Documentation on Agents

Agents APIs (image 2 of 3) What this shows Click here to access Voice AI API Documentation on Agents What this shows Illustrates the "Agents APIs" section of "Voice AI Public APIs". This screenshot appears in the "Agents APIs" section of "Voice AI Public APIs". The text alongside this image reads: Click here to access Voice AI API Documentation on Agents. This part of the guide covers 1 field, listed below. Immediately after, the guide continues: Actions define what an agent can do; such as invoking a webhook, retrieving data, or posting results. The Actions APIs enable you to create and update these behaviors programmatically and keep them synchronized with your systems. See API…. Image 2 of 3 What to clickClick here to access Voice AI API Documentation on Agents
Fields in this part of the guide Patch Agent: Partially update an existing Voice AI agent
Next stepActions define what an agent can do; such as invoking a webhook, retrieving data, or posting results. The Actions APIs enable you to create and update these behaviors programmatically and keep them synchronized with your systems. See API Reference docs for additional details.
All 5 steps in this procedure
  1. Create Agent: Create a new Voice AI agent configuration and settings
  2. Patch Agent: Partially update an existing Voice AI agent
  3. List Agents: Retrieve a paginated list of agents for given location
  4. Get Agent: Retrieve detailed configuration and settings for a specific Voice AI agent
  5. Delete Agent: Delete a Voice AI agent and all its configurations

Actions APIs

Actions define what an agent can do; such as invoking a webhook, retrieving data, or posting results. The Actions APIs enable you to create and update these behaviors programmatically and keep them synchronized with your systems. See API Reference docs for additional details.

  • Create Agent Action: Create a new action for a voice AI agent. Actions define specific behaviors and capabilities for the agent during calls.
  • Update Agent Action: Update an existing action for a voice AI agent. Modifies the behavior and configuration of an agent action.
  • Get Agent Action: Retrieve details of a specific action by its ID. Returns the action configuration including actionParameters.
  • Delete Agent Action: Delete an existing action from a voice AI agent. This permanently removes the action and its configuration.

Click here to access Voice AI API Documentation on Actions

Actions APIs (image 3 of 3) What this shows Click here to access Voice AI API Documentation on Actions What this shows Illustrates the "Actions APIs" section of "Voice AI Public APIs". This screenshot appears in the "Actions APIs" section of "Voice AI Public APIs". The text alongside this image reads: Click here to access Voice AI API Documentation on Actions. Immediately after, the guide continues: Q: Can I manage voices via API? Image 3 of 3 What to clickClick here to access Voice AI API Documentation on Actions Next stepQ: Can I manage voices via API?
All 4 steps in this procedure
  1. Create Agent Action: Create a new action for a voice AI agent. Actions define specific behaviors and capabilities for the agent during calls.
  2. Update Agent Action: Update an existing action for a voice AI agent. Modifies the behavior and configuration of an agent action.
  3. Get Agent Action: Retrieve details of a specific action by its ID. Returns the action configuration including actionParameters.
  4. Delete Agent Action: Delete an existing action from a voice AI agent. This permanently removes the action and its configuration.

Frequently Asked Questions

Q: Can I manage voices via API?

Yes. You can use the Voices APIs to retrieve available voices and fetch detailed metadata, including preview URLs, to help select the right voice for your agent.

Q: Do I need special permissions to use these APIs?
You must have appropriate GHL Customer Care access to manage Voice AI and read call data. Coordinate with your account admin if you can’t access certain resources.

Q: Where can I find the most current endpoints and request/response schemas?
Always use the official API docs: Click here to view API Documentation


Was this guide helpful?

Related guides