Skip to main content
POST
Create agent

Authorizations

x-api-key
string
header
required

Send your Callin API key in the x-api-key header.

Body

application/json

Create-agent payload (createPublicAgentSchema): name, direction, tags, nested conversationConfig and platformSettings.

name
string
required

Display name for the agent.

conversationConfig
object
required
direction
enum<string>

Whether the agent handles outbound calls, inbound calls, or both. Defaults to outbound.

Available options:
outbound,
inbound,
both
tags
string[]

Tags for organizing agents.

platformSettings
object

The platform settings of the agent

Response

Agent created successfully. Returns the new agent data.

After creating an agent, use data.agentId in follow-up calls.

success
boolean
Example:

true

data
object