Custom Telephony
Import Phone Number
Call (V2)
Phone Number
Agent
Retell LLM Response Engine (for single / multi prompt agent)
Knowledge Base
Batch call
Account
Custom Telephony
Custom LLM
Custom Telephony
Import Phone Number
Import a phone number from custom telephony & Bind agents
POST
/
import-phone-number
import Retell from 'retell-sdk';
const client = new Retell({
apiKey: 'YOUR_RETELL_API_KEY',
});
async function main() {
const phoneNumberResponse = await client.phoneNumber.import({
phone_number: '+14157774444',
termination_uri: 'someuri.pstn.twilio.com',
});
console.log(phoneNumberResponse.inbound_agent_id);
}
main();
{
"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
Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"
Body
application/json
Response
201
application/json
Successfully imported a number.
The response is of type object
.
Was this page helpful?
import Retell from 'retell-sdk';
const client = new Retell({
apiKey: 'YOUR_RETELL_API_KEY',
});
async function main() {
const phoneNumberResponse = await client.phoneNumber.import({
phone_number: '+14157774444',
termination_uri: 'someuri.pstn.twilio.com',
});
console.log(phoneNumberResponse.inbound_agent_id);
}
main();
{
"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
}