agent-phone-numbers

Bulk Upload Phone Numbers

Bulk upload phone numbers from CSV file.

CSV Format: phone_number,provider,enable_outbound,outbound_address,outbound_transport,destination_country,media_encryption,krisp_enabled,auth_username,auth_password

Example CSV:

phone_number,provider,enable_outbound,outbound_address,outbound_transport,destination_country,media_encryption,krisp_enabled
+15551234567,twilio,true,sip.twilio.com,TCP,US,ALLOW,true
+15559876543,vonage,true,sip.nexmo.com,TLS,US,ALLOW,true
+918012345678,plivo,true,sip.plivo.com,TLS,IN,REQUIRE,true

This endpoint processes the CSV file and registers all phone numbers in bulk. Each row is processed independently - partial success is possible.

POST

agents

{agent_id}

phone-numbers

bulk-upload

Bulk Upload Phone Numbers

curl --request POST \
  --url https://api.example.com/agents/{agent_id}/phone-numbers/bulk-upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=<string>'

{
  "total_uploaded": 123,
  "successful": 123,
  "failed": 123,
  "results": [
    {}
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id

string<uuid>

required

Body

multipart/form-data

file

string

required

CSV file with phone numbers

Response

Successful Response

Response for bulk phone number upload.

total_uploaded

integer

required

successful

integer

required

failed

integer

required

results

Results · object[]

required

Diagnose Sip TrunkDiagnose SIP trunk configuration for a phone number. Returns detailed information about: - Whether a trunk exists in LiveKit - Configured allowed_addresses (IP allowlist) - Whether a dispatch rule exists - Issues and recommendations Use this to troubleshoot inbound calls not reaching LiveKit.

Bulk Upload Phone Numbers

curl --request POST \
  --url https://api.example.com/agents/{agent_id}/phone-numbers/bulk-upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=<string>'

{
  "total_uploaded": 123,
  "successful": 123,
  "failed": 123,
  "results": [
    {}
  ]
}

Documentation Index

Authorizations

Path Parameters

Body

Response