Move phone number API
Move a phone number between the main account and sub-accounts in your Bolna organization. An enterprise feature that needs sub-accounts.
enterprise feature and requires an organization account with sub-accounts.- Pass
nullforsource_sub_account_idortarget_sub_account_idto refer to the main (organization) account. source_sub_account_idmust match the sub-account the number currently belongs to.- The phone number must not be linked to an agent. Unlink the inbound agent before moving it.
- Multi-tenant sub-accounts are not supported as a source or target.
POST /phone-numbers/transfer. That path still works but is deprecated, so use /phone-numbers/move in new integrations.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Phone number to move, along with its current (source) and new (target) sub-account
The id of the phone number to move, from the List phone numbers API
"123e4567-e89b-12d3-a456-426614174000"
The sub-account id the phone number currently belongs to. Pass null if the number is on the main (organization) account.
null
The sub-account id to move the phone number to. Pass null to move it back to the main (organization) account. Must be different from source_sub_account_id.
"a3f1c2d4-5e6b-4c7d-8e9f-0a1b2c3d4e5f"
Response
Phone number move response
"Phone number moved successfully"
The id of the moved phone number
"123e4567-e89b-12d3-a456-426614174000"
The sub-account the phone number was moved from (null for the main account)
null
The sub-account the phone number was moved to (null for the main account)
"a3f1c2d4-5e6b-4c7d-8e9f-0a1b2c3d4e5f"

