Import phone number

Import a phone number from custom telephony and bind agents

AuthorizationBearer

Clerk JWT token or OrtaVox API key (sk_live_… or pk_live_…)

x-api-keystring

OrtaVox API key (alternative to Bearer token)

This endpoint expects an object.

phone_numberstringRequired

E.164 format phone number

termination_uristringRequired

SIP trunk termination URI

directionenumOptional

Which direction(s) to configure - inbound only, outbound only, or both. Defaults to both if not specified.

Allowed values:

sip_auth_usernamestringOptional

SIP authentication username (required)

sip_auth_passwordstringOptional

SIP authentication password (required)

inbound_agent_idstringOptionalformat: "uuid"

Agent ID for inbound calls

outbound_agent_idstringOptionalformat: "uuid"

Agent ID for outbound calls

inbound_agent_versionintegerOptional

Inbound agent version

outbound_agent_versionintegerOptional

Outbound agent version

nicknamestringOptional

Friendly name for the phone number

inbound_webhook_urlstringOptionalformat: "uri"

Webhook URL for inbound call events

Phone number imported successfully

dataobject or null

1	import requests
2
3	url = "https://api.ortavox.ai/v1/telephony/import"
4
5	payload = {
6	"phone_number": "+14157774444",
7	"termination_uri": "sip.uk.didlogic.net"
8	}
9	headers = {
10	"Authorization": "Bearer <token>",
11	"Content-Type": "application/json"
12	}
13
14	response = requests.post(url, json=payload, headers=headers)
15
16	print(response.json())