Bring Your Own Carrier (BYOC)

If you already have your own SIP trunk (Telnyx, Twilio, Vonage, Plivo, or any SIP provider), BYOC lets you route your AI voice agent's inbound and outbound calls over your carrier. You register the trunk with Edesy, add its SIP endpoints, and register your numbers — then use them with your agent.

All resources are tenant-isolated: you can only see and manage your own trunks, gateways, and numbers.

The flow

1. Register your SIP trunk as a Carrier.
2. Add the trunk's SIP Gateway endpoint(s).
3. Register your Phone Numbers (DIDs) and link them to the carrier.
4. Point your calls through the trunk — inbound and outbound.

Base path

https://voice-api.edesy.in/v1/trunk-portal

All endpoints require Authorization: Bearer <token> and are automatically scoped to your tenant. See Authentication.

Prefer a UI? You can also register carriers, gateways, and numbers from the portal at voice-app.edesy.in — and generate the API token used here.

1. Carriers (SIP trunks)

A Carrier represents a SIP trunk provider (e.g. "My Telnyx Trunk", "Office PBX").

Create a carrier

POST /v1/trunk-portal/carriers

Registration-based trunk (Telnyx, Twilio):

curl -X POST https://voice-api.edesy.in/v1/trunk-portal/carriers \
  -H "Authorization: Bearer vp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Telnyx Trunk",
    "requires_register": true,
    "register_username": "myuser",
    "register_password": "mypassword",
    "register_sip_realm": "sip.telnyx.com"
  }'

IP-authenticated trunk (static IP):

curl -X POST https://voice-api.edesy.in/v1/trunk-portal/carriers \
  -H "Authorization: Bearer vp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Office PBX",
    "description": "Direct trunk from our office PBX",
    "tech_prefix": "99"
  }'

Response (201 Created):

{
  "data": {
    "sid": "429ea78b-9af7-4ff7-963f-41e0762b9c7a",
    "name": "My Telnyx Trunk",
    "metadata": {
      "description": "",
      "requires_register": true,
      "tech_prefix": "",
      "dtmf_type": ""
    },
    "created_at": "2026-04-05T12:00:00Z"
  }
}

Save the carrier sid — you need it to add gateways and register phone numbers.

Other carrier operations:

2. SIP gateways

A Gateway is the actual network endpoint (IP or hostname) of the SIP trunk. Each carrier can have one or more gateways (e.g. primary + failover).

Create a gateway

POST /v1/trunk-portal/carriers/:carrier_sid/gateways

curl -X POST https://voice-api.edesy.in/v1/trunk-portal/carriers/429ea78b-.../gateways \
  -H "Authorization: Bearer vp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ipv4": "sip.telnyx.com",
    "port": 5060,
    "inbound": true,
    "outbound": true,
    "protocol": "udp"
  }'

Response (201 Created):

{
  "data": {
    "sid": "abc12345-...",
    "carrier_sid": "429ea78b-...",
    "name": "sip.telnyx.com:5060",
    "metadata": {
      "ipv4": "sip.telnyx.com",
      "port": 5060,
      "inbound": true,
      "outbound": true,
      "protocol": "udp"
    }
  }
}

Other gateway operations:

3. Phone numbers

Phone Numbers (DIDs) are the numbers you want to use with the voice agent. Each must be linked to a carrier and, optionally, an application.

Register a number

POST /v1/trunk-portal/numbers

curl -X POST https://voice-api.edesy.in/v1/trunk-portal/numbers \
  -H "Authorization: Bearer vp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "+919876543210",
    "carrier_sid": "429ea78b-...",
    "application_sid": "207fd2f9-..."
  }'

Response (201 Created):

{
  "data": {
    "sid": "num12345-...",
    "number": "+919876543210",
    "metadata": {
      "carrier_sid": "429ea78b-...",
      "application_sid": "207fd2f9-..."
    }
  }
}

Other number operations:

4. Applications

Applications define the webhook endpoints called when a call arrives or is placed. For most BYOC setups you use the default Edesy application that connects calls to the AI voice agent — custom applications are for advanced users who want direct webhook control.

POST /v1/trunk-portal/applications

curl -X POST https://voice-api.edesy.in/v1/trunk-portal/applications \
  -H "Authorization: Bearer vp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Voice Agent App",
    "call_hook_url": "https://voice-api.edesy.in/v1/webhooks/voice/call-hook",
    "call_status_url": "https://voice-api.edesy.in/v1/webhooks/voice/call-status",
    "record_all_calls": true
  }'

Also available: GET /v1/trunk-portal/applications, GET /v1/trunk-portal/applications/:app_sid, PATCH …/:app_sid, DELETE …/:app_sid.

5. Call logs

Retrieve call detail records (CDRs) for monitoring and debugging.

GET /v1/trunk-portal/call-logs?page=1&count=25

Complete setup flow

Adding your own Telnyx SIP trunk end to end:

# 1. Create the carrier
CARRIER=$(curl -s -X POST https://voice-api.edesy.in/v1/trunk-portal/carriers \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{
    "name": "My Telnyx Trunk",
    "requires_register": true,
    "register_username": "telnyx_user_123",
    "register_password": "telnyx_pass_456",
    "register_sip_realm": "sip.telnyx.com"
  }')
CARRIER_SID=$(echo $CARRIER | jq -r '.data.sid')

# 2. Add the SIP gateway
curl -s -X POST "https://voice-api.edesy.in/v1/trunk-portal/carriers/$CARRIER_SID/gateways" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"ipv4": "sip.telnyx.com", "port": 5060, "inbound": true, "outbound": true, "protocol": "udp"}'

# 3. Register a phone number (using the default voice-agent application)
curl -s -X POST https://voice-api.edesy.in/v1/trunk-portal/numbers \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d "{\"number\": \"+919876543210\", \"carrier_sid\": \"$CARRIER_SID\"}"

Then, on your SIP provider's side (e.g. the Telnyx dashboard), point the trunk to Edesy and use either IP-based auth (allowlist Edesy's address) or SIP registration, as configured with your account.

Common provider configurations

Next

• Phone Numbers — wire an Edesy-provisioned Indian DID instead of your own
• Error Codes