Skip to main content
POST
/
agent
/
Create Agent
curl --request POST \
  --url https://api.callaidan.com/agent/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "chatbot",
  "assistant_id": "<string>",
  "description": "<string>",
  "prompt": "<string>",
  "first_message": "<string>",
  "timezone": "<string>",
  "webhook_url": "<string>",
  "webhook_headers": {},
  "branding_colour": "<string>",
  "model": "gpt-4.1"
}
'
"<string>"

Authorizations

​
Authorization
string
header
required

Company API Key

Body

application/json

Agent creation details

​
name
string
required

Name of the agent

​
type
enum<string>
required

Agent type discriminator

Available options:
chatbot
​
assistant_id
string

Internal assistant identifier (optional)

​
description
string

If present, used to generate the prompt

​
prompt
string

Used only if no description is provided

​
first_message
string

First message shown in supported chat surfaces

​
timezone
string

Timezone name (e.g. "America/New_York")

​
webhook_url
string

Webhook URL (if applicable)

​
webhook_headers
object

Optional HTTP headers sent with the end-of-call webhook POST. Each value may be a plain string (non-secret) or {value, secret} — when secret is true, the value is masked in subsequent API reads but still sent on the outbound request.

​
branding_colour
string

"" or hex #RGB / #RRGGBB

​
model
string
default:gpt-4.1

Chat model name (defaults to gpt-4.1)

Response

Agent created successfully

The ID of the newly created agent