Import phone number
POST
Import a number the connected account already owns and attach it to the Waylo trunk. Importing replaces the number's current call routing at the carrier. Refused when the account does not own it (422), when another workspace or tenant has it active (409), or when the agent is not in the workspace (422). Answers with the number, active or failed with a statusReason — a failure is its state, not a failed request, retried with provision.
Access: workspace_admin · API key phone_numbers:write
api-keyheader
AuthorizationBearer <sk_waylo_<lookup><secret><checksum>>application/json- body
provider*"twilio"Value in
"twilio"connectionId*stringFormat
uuidworkspaceId*stringFormat
uuide164*stringMatch
^\+[1-9]\d{1,14}$name?|Length
1 <= length <= 100agentId?|Format
uuidCreated
application/json- response
id*stringworkspaceId*stringconnectionId*stringconnectionName*stringprovider*"twilio"Value in
"twilio"e164*stringproviderNumberId*stringname*string|nullagentId*|Format
uuidagentName*string|nullstatus*stringValue in
"activating""active""failed"statusReason*string|nullactive*booleancreatedByUserId*|Format
uuidcreatedByUserName*string|nullupdatedByUserId*|Format
uuidupdatedByUserName*string|nullcreatedAt*stringFormat
date-timeupdatedAt*stringFormat
date-timecurl -X POST 'https://api.poc.app.waylovoice.ai/phone-numbers' \ -H 'Authorization: Bearer sk_waylo_...' \ -H 'Content-Type: application/json' \ -d '{ "provider": "twilio", "connectionId": "84b500d7-71c8-4b1f-adf4-f1eb0000973d", "workspaceId": "ef0efa32-d1c1-43d4-a5e2-fe7b4f00403c", "e164": "+15005550006"}'Example Response
{ "id": "string", "workspaceId": "string", "connectionId": "string", "connectionName": "string", "provider": "twilio", "e164": "string", "providerNumberId": "string", "name": "string", "agentId": "bc309ecf-5f66-4057-93c5-6611cc9cb7b2", "agentName": "string", "status": "activating", "statusReason": "string", "active": true, "createdByUserId": "4d2aef9a-17b0-44e6-902e-616812033620", "createdByUserName": "string", "updatedByUserId": "b38eaad7-8efa-49e7-b0aa-619916a3821e", "updatedByUserName": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}