Add a new transfer number to an agent
Header Parameters
Authorizationstring
Path Parameters
idstring Required
Body Parameters
labelstring Required
Single lowercase word label (e.g., sales, support)
descriptionstring Required
Description explaining when AI should transfer to this number
Max length
140
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
Show child attributes
transferTypestring
Transfer type: "warm" (AI briefs recipient before connecting) or "cold" (direct transfer)
Default value
warm
Enum values:
warmcoldisActiveboolean
Whether this transfer number is active
Default value
true
Response
201
Object
Transfer number created successfully
Response Attributes
idstring Required
labelstring Required
descriptionstring Required
phoneNumberstring Required
workHoursobject | null
transferTypestring Required
Default value
warm
Enum values:
warmcoldisActiveboolean Required
sortOrdernumber Required
createdAtstring Required
updatedAtstring Required
400
Object
Maximum 20 transfer numbers allowed or invalid data
409
Object
Label already exists for this agent
Was this section helpful?
Response
Was this section helpful?