Import Phone Number

​

Request

• X-Authorization: Your API key (required)
• Content-Type: application/json

{
  "uid": "string",
  "agentId": "string",
  "source": "string",
  "twilioAccountSid": "string",
  "twilioAuthToken": "string",
  "phoneNumber": "string",
  "countryCode": "string"
}

• uid (string, required): Your user ID
• agentId (string, required): The ID of the agent to assign the phone number to
• source (string, required): Must be “twilio” (only Twilio is currently supported)
• twilioAccountSid (string, required): Your Twilio Account SID
• twilioAuthToken (string, required): Your Twilio Auth Token
• phoneNumber (string, required): The phone number to import
• countryCode (string, required): The country code for the phone number

​

Response

{
  "message": "string"
}

• 400 Bad Request: Invalid request body, invalid source, or agent already has a phone number
• 401 Unauthorized: Invalid or missing API key, or insufficient permissions
• 500 Internal Server Error: Agent not found, user needs paid plan, or server error

​

Example

curl -X POST https://app.phonely.ai/api/import-number \
  -H "X-Authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "user123",
    "agentId": "agent456",
    "source": "twilio",
    "twilioAccountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "twilioAuthToken": "your-twilio-auth-token",
    "phoneNumber": "+1234567890",
    "countryCode": "US"
  }'

​

Notes

• Only Twilio phone numbers are currently supported
• The agent must be on a paid plan to import phone numbers
• The agent cannot already have a business phone number assigned
• This operation has a maximum duration of 60 seconds