Skip to main content
The Agent Studio API lets you programmatically interact with AI agents built in the HoopAI Agent Studio. Use it to list available agents, retrieve agent details, and execute agents to get AI-powered responses — all through a simple REST interface.

​
Base URL

https://services.leadconnectorhq.com

​
Authentication

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

​
OAuth scopes

ScopeAccess
agent-studio.readonlyList and retrieve agents
agent-studio.writeExecute agents

​
Quick start

Execute an agent and get a response: 
curl -X POST https://services.leadconnectorhq.com/agent-studio/public-api/agents/agent_abc123/execute \
  -H "Authorization: Bearer <access_token>" \
  -H "Version: 2021-04-15" \
  -H "Content-Type: application/json" \
  -d '{
    "locationId": "ve9EPM428h8vShlRW1KT",
    "message": "What services do you offer?",
    "contactId": "contact_abc123"
  }'
The response includes an executionId that you can pass in follow-up requests to maintain conversation context.

​
Endpoints

MethodPathDescription
GET/agent-studio/public-api/agentsList all agents for a location
GET/agent-studio/public-api/agents/{agentId}Get agent details by ID
POST/agent-studio/public-api/agents/{agentId}/executeExecute an agent
Last modified on March 7, 2026