Create a new agent
Creates a voice AI agent with the provided configuration. The agent won't receive calls until a phone number is assigned, but it can be tested immediately. Instructions are validated by an LLM and rejected if vague or off-topic. Subscription agent-count limits are enforced. Mobile users auto-get isVoiceMailAgent=true; avatar is auto-generated from name.
Request
- Base URL: https://be.skipcalls.com (the document declares no server; this is the origin it was published from)
- URL: https://be.skipcalls.com/agents
- Auth: HTTP bearer
Request body
Voice to use for the agent
Words or short phrases passed to LiveKit as speech-to-text keyterms
Voice pace from slow to fast. 0.5 is normal/provider default. Not all voice providers support speed control.
Whether the agent has access to knowledge
Knowledge access mode for the agent
Tags that the agent has access to (only used when knowledgeAccessMode is TAGS_ONLY)
Include the user's profile info (owner name, phone, address, DOB, company) in the agent prompt.
Include business Q&A presets (hours, pricing, services) from /business-profile in the agent prompt
Use per-agent receptionist profile fields in prompts instead of only the account profile
Prompt-facing represented person, practice, or business name
Prompt-facing represented company or business name
Prompt-facing represented company website
Prompt-facing represented company description
Prompt-facing represented company industry
Prompt-facing represented business street address
Prompt-facing represented business city
Prompt-facing represented business state
Prompt-facing represented business ZIP/postal code
Prompt-facing represented business timezone as an IANA timezone name
First message to send from the agent
Whether recipients can interrupt the initial greeting on outbound calls
Whether the generated voice prompt includes provider-specific expression guidance
Closing phrase the agent says before ending an inbound call
Seconds to wait before the voice agent joins an inbound call.
Voice recognition mode: EN for English-only (highest accuracy), MULTI for multilingual support
Whether the agent allows follow-ups
Custom instructions for smart follow-up messages. When provided, the AI uses these to guide follow-up content.
Whether the agent allows gathering information on incoming call
Max duration of incoming call in minutes
Max duration of outgoing call in minutes
Instructions for the agent on incoming calls
Welcoming voice mail message for contacts
Welcoming voice mail message for others
Is agent a voice mail agent
Whether the agent has a typing sound for incoming calls
Whether the agent has a background sound for incoming calls
Whether the agent has a typing sound for outgoing calls
Whether the agent has a background sound for outgoing calls
Whether the agent allows incoming SMS messages
Instructions for the agent on incoming SMS messages
Whether the agent automatically responds to SMS messages
Delay in seconds before responding to SMS messages
Post-call SMS message to send after incoming calls complete
Whether the agent can send SMS messages during calls via the send_sms tool
Whether to create audio recordings for calls. Text transcripts remain available when disabled.
Whether the agent requires data consent before starting calls
Custom text/instructions for what consent is being requested for
Whether to enable post-call outbound actions (scheduling calls after incoming calls)
Strictly reject incoming calls detected as spam before connecting to the agent
Skip AI: every contact synced from the owner's phone goes to the Skip AI voicemail instead of the receptionist. Contacts saved after calls, on the web, or by import are not included.
Custom rule for detecting valuable incoming calls after each call. Max 300 characters.
UUID of a verified caller ID to use for outbound calls. Null to clear.
Example request
{
"receptionistTimezone": "America/New_York"
}Response
The agent has been successfully created.
Agent name
Agent description
Agent avatar
Is agent public
Is agent active
Agent instructions
Agent instructions for incoming calls
Max duration of incoming call in minutes
Max duration of outgoing call in minutes
Whether the agent allows gathering information on incoming call
Agent created at
Agent updated at
Is agent allowed to access knowledge
Knowledge access mode for the agent
Tags that the agent has access to when knowledge access is tag-limited
Is agent allowed to schedule follow-ups
Custom instructions for smart follow-up messages
Whether the user's profile info (owner name, phone, address, DOB, company) is included in the agent prompt
Whether business Q&A presets are shared with this agent in prompts
Whether prompts should use this agent-specific represented receptionist profile
Prompt-facing represented person, practice, or business name
Prompt-facing represented company or business name
Prompt-facing represented company website
Prompt-facing represented company description
Prompt-facing represented company industry
Prompt-facing represented business street address
Prompt-facing represented business city
Prompt-facing represented business state
Prompt-facing represented business ZIP/postal code
Prompt-facing represented business timezone as an IANA timezone name
Agent voice
First message to be sent to the agent
Whether recipients can interrupt the initial greeting on outbound calls
Whether the generated voice prompt includes provider-specific expression guidance
Closing phrase the agent says before ending an inbound call
Seconds to wait before the voice agent joins an inbound call.
Voice recognition mode: EN for English-only (highest accuracy), MULTI for multilingual support
Names and special words the speech recognizer should expect on calls
Temperature for the agent
Welcoming voice mail message for contacts
Welcoming voice mail message for others
Is agent a voice mail agent
Voice pace from slow to fast. 0.5 is normal/provider default. Not all voice providers support speed control.
Typing sound for the agent
Background sound for the agent
Background sound for the agent
Typing sound for the agent
Whether the agent allows incoming SMS messages
Instructions for the agent on incoming SMS messages
Whether the agent automatically responds to SMS messages
Delay in seconds before responding to SMS messages
Post-call SMS message to send after incoming calls complete
Whether the agent can send SMS messages during calls via the send_sms tool
Whether calls produce audio recordings. Text transcripts remain available when disabled.
Whether the agent requires data consent before starting calls
Custom text/instructions for what consent is being requested for
Whether to enable post-call outbound actions (scheduling calls after incoming calls)
Strictly reject incoming calls detected as spam before connecting to the agent
Skip AI: every contact synced from the owner's phone goes to the Skip AI voicemail instead of the receptionist. Contacts saved after calls, on the web, or by import are not included.
Custom rule for detecting valuable incoming calls after each call.
UUID of a verified caller ID to use for outbound calls. Null to clear.
Example response
{
"tools": [
{
"tool": {
"toolType": "HTTP"
}
}
],
"phoneNumbers": [
{
"createdAt": "2021-01-01T00:00:00Z",
"updatedAt": "2021-01-01T00:00:00Z",
"phoneNumber": "+1234567890",
"country": "US",
"agentId": "123",
"direction": "INCOMING"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.