Skip to main content
POST
cURL

Authorizations

X-API-Key
string
header
required

Customer API key created in the Sendora dashboard.

Headers

X-API-Key
string | null
Authorization
string | null

Body

application/json
name
string
required

Name returned by the Sendora API.

Required string length: 1 - 120
template
string
required

Template returned by the Sendora API.

Maximum string length: 40
type
string
required

chat creates a chat agent from a template; leave type out to create a voice agent.

Allowed value: "chat"
business
string
default:""

Business returned by the Sendora API.

Maximum string length: 200
channels
enum<string>[]

Channels returned by the Sendora API.

Maximum array length: 3
Available options:
sms,
whatsapp,
email

Response

Successful Response

Deliberately minimal public representation of a voice agent.

The authenticated operator API returns the full configuration, but public API keys must not receive system prompts, tool definitions, tenant IDs, or connected service resource identifiers as an incidental side effect of listing an agent. Configuration is accepted on write requests but is never echoed.

created_at
string<date-time>
required

Created at returned by the Sendora API.

id
string
required

The voice agent's id. Pass it to any endpoint that takes agent_id.

name
string
required

Name returned by the Sendora API.

direction
string
default:outbound

Direction returned by the Sendora API.

display_name
string | null

Display name returned by the Sendora API.

first_message
string
default:""

First message returned by the Sendora API.

is_active
boolean
default:false

Is active returned by the Sendora API.

ready
boolean
default:false

Ready returned by the Sendora API.

updated_at
string<date-time> | null

Updated at returned by the Sendora API.