Skip to main content
POST
/
v1
/
agents
Create Agent
curl --request POST \
  --url https://api.agenthuman.com/v1/agents \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "avatar_image_url": "<string>",
  "voice_agent": {}
}
'
{
  "success": true,
  "agent": {
    "agent_id": "agnt_01J8ZK4R2N5M6P7Q8W4T",
    "name": "Support Agent",
    "avatar_image_url": "https://cdn.example.com/avatars/support.jpg",
    "created_at": "2024-01-15T10:00:00Z",
    "voice_agent": {
      "provider": "ElevenLabs",
      "agent_id": "el_agent_xxxxxxxxxxxxxxxx",
      "auth_method": "public"
    }
  }
}
What This Does: Creates an Agent that combines your display settings (name, avatar) with a VoiceAgent pointing to an external voice AI provider. The agent can then be shared via Links.

​
Body

​
name
string
required
Display name for the agent (e.g. "Support Bot", "Sales Assistant").
​
avatar_image_url
string
URL of the avatar image to display to end-users. Optional — can be null.
​
voice_agent
object
required
Voice AI provider configuration.
  • provider (string, required): Provider name (e.g. "ElevenLabs")
  • agent_id (string, required): The agent’s ID on the provider’s platform
  • auth_method (string, required): One of public, api_key or token

​
Response

​
success
boolean
Whether the agent was created successfully.
​
agent
object
The created Agent object.
{
  "success": true,
  "agent": {
    "agent_id": "agnt_01J8ZK4R2N5M6P7Q8W4T",
    "name": "Support Agent",
    "avatar_image_url": "https://cdn.example.com/avatars/support.jpg",
    "created_at": "2024-01-15T10:00:00Z",
    "voice_agent": {
      "provider": "ElevenLabs",
      "agent_id": "el_agent_xxxxxxxxxxxxxxxx",
      "auth_method": "public"
    }
  }
}