agents

Add a new transfer number to an agent

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.

post/agents/{id}/transfer-numbers

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/{id}/transfer-numbers
  • Auth: HTTP bearer

Path parameters

idstring required

Request body

labelstring required

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

descriptionstring required

Description explaining when AI should transfer to this number

phoneNumberstring required

Phone number (will be normalized to E.164)

workHoursobject

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

transferType'warm' | 'cold'

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

isActiveboolean

Whether this transfer number is active

Example request

{
  "label": "sales",
  "description": "Use for sales inquiries and new customer questions",
  "phoneNumber": "+1234567890",
  "workHours": {
    "MONDAY": [
      900,
      1730
    ],
    "TUESDAY": [
      900,
      1730
    ]
  }
}

Response

Transfer number created successfully

idstring required
labelstring required
descriptionstring required
phoneNumberstring required
workHoursobject nullable
transferType'warm' | 'cold' required
isActiveboolean required
sortOrdernumber required
createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.