SIP inbound trunk

To provision an inbound trunk with the SIP Service, use the CreateSIPInboundTrunk API. It returns an SIPInboundTrunkInfo object that describes the created SIP trunk. These parameters can also be queried at any time using the ListSIPInboundTrunk API.

Minimal inbound trunk

The following creates an inbound trunk with minimal configuration. It will accept all inbound calls to number +15105550100.

Create a file at inbound-trunk.json with the following content:

{
  "trunk": {
    "name": "Demo inbound trunk",
    "numbers": ["+15105550100"]
  }
}

Then create the inbound trunk using lk:

lk sip inbound create inbound-trunk.json

Accepting calls from specific phone numbers and IPs

The configuration for inbound trunk will accept inbound calls to number +15105550100 from caller numbers +13105551100 and +17145550100 and IP range 1.1.1.0/24.

{
  "trunk": {
    "name": "Demo inbound trunk",
    "numbers": ["+15105550100"],
    "allowed_numbers": ["+13105550100", "+17145550100"],
    "allowed_addresses": ["1.1.1.0/24"]
  }
}

Enabling authentication for inbound calls

The following inbound trunk configuration requires user/password authentication from a SIP Trunk Provider:

{
  "trunk": {
    "name": "Demo inbound trunk",
    "numbers": ["+15105550100"],
    "auth_username": "<sip-inbound-user>",
    "auth_password": "<sip-inbound-pass>"
  }
}