Skip to main content
The Conversation AI API lets you create and manage AI agents that automatically handle conversations with contacts. Use it to configure agent behaviors, attach custom actions (such as booking appointments or triggering workflows), manage follow-up settings, and track AI-generated responses.

​
Base URL

https://services.leadconnectorhq.com

​
Authentication

All endpoints require a Bearer token and an API version header. 
Authorization: Bearer <access_token>
Version: 2021-07-28
See OAuth 2.0 to obtain an access token.

​
OAuth scopes

ScopeAccess
conversation-ai.readonlyRead agents, actions, and generation data
conversation-ai.writeCreate, update, and delete agents and actions

​
Quick start

Search for existing Conversation AI agents in a location: 
curl -X GET "https://services.leadconnectorhq.com/conversation-ai/agents/search?locationId=ve9EPM428h8vShlRW1KT" \
  -H "Authorization: Bearer <access_token>" \
  -H "Version: 2021-07-28"

​
Endpoints

MethodPathDescription
POST/conversation-ai/agentsCreate a new AI agent
GET/conversation-ai/agents/searchSearch for agents
GET/conversation-ai/agents/{agentId}Get agent details
PUT/conversation-ai/agents/{agentId}Update an agent
DELETE/conversation-ai/agents/{agentId}Delete an agent
POST/conversation-ai/agents/{agentId}/actionsAttach an action to an agent
GET/conversation-ai/agents/{agentId}/actions/listList agent actions
GET/conversation-ai/agents/{agentId}/actions/{actionId}Get action details
PUT/conversation-ai/agents/{agentId}/actions/{actionId}Update an action
DELETE/conversation-ai/agents/{agentId}/actions/{actionId}Remove an action
PATCH/conversation-ai/agents/{agentId}/followup-settingsUpdate follow-up settings
GET/conversation-ai/generationsGet generation details
Last modified on March 7, 2026