API Reference
  1. SkipCalls Public API
  2. agents

Add a new transfer number to an agent

post
https://be.skipcalls.com/agents//transfer-numbers

Creates a routing option the agent can forward calls to. Label must be lowercase letters only and unique per agent. Phone in E.164 format, restricted to supported countries. Work hours use HHMM format per weekday; omit for 24/7. Hard limit of 20 transfer numbers per agent.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params
string
required

Single lowercase word label (e.g., sales, support)

string
required
length ≤ 140

Description explaining when AI should transfer to this number

string
required

Phone number (will be normalized to E.164)

workHours
object

Work hours schedule by day (e.g., {MONDAY: [900, 1730]}). Null means 24/7

string
enum
Defaults to warm

Transfer type: "warm" (AI briefs recipient before connecting) or "cold" (direct transfer)

Allowed:
boolean
Defaults to true

Whether this transfer number is active

Responses

400

Maximum 20 transfer numbers allowed or invalid data

409

Label already exists for this agent

Updated about 6 hours ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 6 hours ago

Did this page help you?