Is there a specific format for the callTo number in the Personal Connection API? I’m sending a simple POST to /api/v2/interaction/outbound/personalconnections/calls with this payload:
{
"callTo": "+5511999999999",
"callFrom": "+12125551234"
}
Getting a 400 error with message “Invalid phone number format”. The docs just say it needs E.164. What am I missing?
You’re hitting a classic E.164 validation trap. The API doesn’t just check for the plus sign; it validates against the configured outbound routing patterns in your org. If your callFrom isn’t an authorized external number or mapped to a specific user/queue, the whole request bombs before it even checks the destination format.
Try wrapping the call in a try-catch to get the specific field error. Here’s a quick curl to isolate the issue:
curl -X POST https://api.nice.incontact.com/api/v2/interaction/outbound/personalconnections/calls \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"callTo": "+5511999999999",
"callFrom": "+12125551234",
"userName": "John Doe"
}'
The userName field is often required for Personal Connection calls to tie the interaction to a specific agent. Without it, the platform rejects the payload as incomplete. Also double-check that +12125551234 is actually provisioned as an external number in your telephony settings. If it’s a virtual number, you might need to use the externalNumber ID instead of the raw string.