AI & Voice Agents

How To Use Conversation AI Public APIs in GoHighLevel

GoHighLevel's Conversation AI public APIs let developers read and write agent configurations programmatically. You can attach actions to agents, list existing actions, update them, and manage agents entirely through API calls. Authentication requires a private integration token scoped to Conversation AI read and write. Once that token is in place, you can automate agent management without touching the UI.

Atualizado em 2 de junho de 2026

9:54

Resumo. GoHighLevel exposes its Conversation AI features through versioned public APIs, giving developers full control over agents and their actions without manual UI work. The API covers attaching appointment booking, workflow triggers, human handover, and other actions to any agent, as well as creating, updating, and deleting agents entirely via code. A private integration token with Conversation AI read and write scopes is the only credential required to get started.

Passos

  1. Open the API 2.0 documentation

    Navigate to the GoHighLevel API 2.0 docs and scroll to the Conversation AI section. You will find action endpoints and agent management endpoints listed there.

  2. Create a private integration token

    In your GoHighLevel account, go to Settings then Private Integrations. Create a new token and add only the Conversation AI Read and Conversation AI Write scopes.

  3. Attach or manage actions via API

    Use the attach-action endpoint to add capabilities such as appointment booking or workflow triggers to an existing agent. Pass the agent ID and the action configuration in the request body.

Perguntas frequentes

What scopes does the API token need for Conversation AI?

Add Conversation AI Read and Conversation AI Write, nothing else is required.

Which actions can I attach to an agent through the API?

Appointment booking, workflow triggers, human handover, contact field collection, and auto follow-up.

Can I delete an agent through the API?

Yes, the agents endpoint supports create, update, and delete operations.

Crie com quem já criou.

Entre na comunidade gratuita: lives semanais, um curso para começar e criadores no seu idioma.

Entre de graça no Skool