Move phone number
Move a caller ID from one campaign to another. For TFU Live campaigns in different sub-accounts, pause both first. Take the number off its other campaigns there. The move succeeds once the number answers calls for the destination campaign. If it stops after the number left the source campaign, retry the same move. Who answers incoming calls is decided as on assign, without the source campaign. The destination answers if no other campaign does and it can answer calls, or if answerCalls lists the number. Allowed customer role: agency_admin.
Required API key scope: phone_numbers:write.
Authorizations
Send your API key as Authorization: Bearer YOUR_API_KEY.
Path Parameters
E.164 phone number. URL-encode the leading + when placing it in the path.
^\+\d{10,15}$Campaign id.
1Body
Destination campaign.
Destination campaign id.
"campaign_speed_to_lead_456"
Numbers whose incoming calls this campaign takes over. A number nobody answers is taken without being listed. Other numbers keep their answering campaign. Each listed number must be on the campaign after this call. The campaign must be able to answer calls.
100^\+\d{10,15}$Response
Phone number moved.
^\+\d{10,15}$"+14155551234"
"campaign_speed_to_lead_123"
"campaign_speed_to_lead_456"
true
Sent only when some are: TFU Live numbers whose incoming calls did not confirm they follow the next campaign that answers them. The change stands, and the platform keeps trying. Check those numbers in Phone Numbers.
^\+\d{10,15}$