Skip to main content
POST
/
import-phone-number
JavaScript
import Retell from 'retell-sdk';

const client = new Retell({
  apiKey: 'YOUR_RETELL_API_KEY',
});

const phoneNumberResponse = await client.phoneNumber.import({
  phone_number: '+14157774444',
  termination_uri: 'someuri.pstn.twilio.com',
});

console.log(phoneNumberResponse.inbound_agent_id);
{
  "phone_number": "+14157774444",
  "phone_number_type": "retell-twilio",
  "phone_number_pretty": "+1 (415) 777-4444",
  "inbound_agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
  "outbound_agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
  "inbound_agent_version": 1,
  "outbound_agent_version": 1,
  "area_code": 415,
  "nickname": "Frontdesk Number",
  "inbound_webhook_url": "https://example.com/inbound-webhook",
  "last_modification_timestamp": 1703413636133
}

Authorizations

​
Authorization
string
header
required

Body

application/json
​
phone_number
string
required
Example:
​
termination_uri
string
required
Example:
​
sip_trunk_auth_username
string
Example:
​
sip_trunk_auth_password
string
Example:
​
inbound_agent_id
string | null
Example:
​
outbound_agent_id
string
Example:
​
inbound_agent_version
integer | null
Example:
​
outbound_agent_version
integer | null
Example:
​
nickname
string
Example:
​
inbound_webhook_url
string | null
Example:

Response

​
phone_number
string
required
Example:
​
last_modification_timestamp
integer
required
Example:
​
phone_number_type
enum<string>
Available options:
retell-twilio,
retell-telnyx,
custom
Example:
​
phone_number_pretty
string
Example:
​
inbound_agent_id
string | null
Example:
​
outbound_agent_id
string | null
Example:
​
inbound_agent_version
integer | null
Example:
​
outbound_agent_version
integer | null
Example:
​
area_code
integer
Example:
​
nickname
string | null
Example:
​
inbound_webhook_url
string | null
Example: