Agents
Assign Phone Number
POST
Assign a phone number to an agent. This enables the agent to handle inbound calls to this number.
For Twilio phone numbers, this endpoint automatically configures the webhook URLs in Twilio.
Headers
string
required
Your API key for authentication.
string
required
The organization ID.
string
required
Must be
application/json.Path Parameters
string
required
The unique identifier of the agent.
Request Body
string
required
The unique identifier of the phone number to assign (format:
phon_[a-f0-9]{12,}).Permissions
phone_numbers:update(admin, agent_manager)
Response
boolean
Indicates if the assignment was successful.
string
Human-readable success message.
object
The updated agent object.
Errors
object
Agent or phone number not found.
object
Access denied to agent or phone number belongs to different organization.
object
Phone number already assigned to another agent, or already assigned to this agent.
object
Phone number has no associated integration (for Twilio numbers).