Skip to main content
POST
Create a new web agent

Authorizations

x-api-key
string
header
required

API Key for authentication

Body

application/json
phoneNumber
string
required

Phone number for the agent

Example:

"+1234567890"

max_duration
number
required

Maximum duration for the agent in seconds

Example:

300

temperature
number
required

Temperature setting for the agent

Example:

0.7

voiceSpeed
number
required

Voice speed setting

Example:

1

similarity
number
required

Similarity setting for voice

Example:

0.75

stability
number
required

Stability setting for voice

Example:

0.5

background_track
string
required

Background track for the agent

Example:

"background_music.mp3"

interruptionThreshold
number
required

Interruption threshold in milliseconds

Example:

1000

calendarID
string
required

Calendar ID for appointments

Example:

"cal_123456"

calendarName
string
required

Calendar name

Example:

"Business Hours"

pathwayID
string
required

Pathway ID

Example:

"path_123456"

customTool
string[]
required

Custom tools metadata

Example:
inboundCustomTool
string[]
required

Inbound custom tools

Example:
waitForGreeting
boolean
required

Wait for greeting setting

Example:

true

questionsData
string[]
required

Agent questions data

Example:
appointmentAgent
boolean
required

Appointment agent setting

Example:

true

task
string
required

Task description

Example:

"Handle customer inquiries"

knowledgeName
string
required

Knowledge base name

Example:

"customer_support"

transferPhoneNumber
string
required

Transfer phone number

Example:

"+1987654321"

selectedVoice
string
required

Selected voice

Example:

"Maya"

model
string
required

AI model to use

Example:

"enhanced"

firstSentence
string
required

First sentence for the agent

Example:

"Hello, how can I help you today?"

selectedLanguage
string
required

Selected language

Example:

"en"

agentName
string
required

Agent name

Example:

"Customer Support Agent"

store
boolean
required

Store setting

Example:

true

webSettings
object

Web agent settings

Response

The web agent has been successfully created.

status
string
Example:

"success"

message
string
Example:

"Agent created successfully"

agent_id
string
Example:

"agent_123456"