sip trunks

register a sip trunk

register one of your own numbers (India, +91 mobile numbers only for now; at most 10 per account). terminationUri is your carrier’s SIP endpoint for calls placed from the number; authUsername / authPassword are the digest credentials it authenticates with — both are required, and the password is never returned. the number is provisioned on the SIP host inside this request; a refusal leaves nothing behind. then point the carrier at the returned originationUri for inbound calls, and assign an agent.

POST

sip-trunks

curl --request POST \
  --url https://silk-api.rumik.ai/v1/sip-trunks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phoneNumber": "+91 98765 43210",
  "displayName": "support line",
  "terminationUri": "sip:pstn.example-carrier.in",
  "authUsername": "silk",
  "authPassword": "s3cret"
}
'

import requests

url = "https://silk-api.rumik.ai/v1/sip-trunks"

payload = {
    "phoneNumber": "+91 98765 43210",
    "displayName": "support line",
    "terminationUri": "sip:pstn.example-carrier.in",
    "authUsername": "silk",
    "authPassword": "s3cret"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    phoneNumber: '+91 98765 43210',
    displayName: 'support line',
    terminationUri: 'sip:pstn.example-carrier.in',
    authUsername: 'silk',
    authPassword: 's3cret'
  })
};

fetch('https://silk-api.rumik.ai/v1/sip-trunks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://silk-api.rumik.ai/v1/sip-trunks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'phoneNumber' => '+91 98765 43210',
    'displayName' => 'support line',
    'terminationUri' => 'sip:pstn.example-carrier.in',
    'authUsername' => 'silk',
    'authPassword' => 's3cret'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://silk-api.rumik.ai/v1/sip-trunks"

	payload := strings.NewReader("{\n  \"phoneNumber\": \"+91 98765 43210\",\n  \"displayName\": \"support line\",\n  \"terminationUri\": \"sip:pstn.example-carrier.in\",\n  \"authUsername\": \"silk\",\n  \"authPassword\": \"s3cret\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://silk-api.rumik.ai/v1/sip-trunks")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"phoneNumber\": \"+91 98765 43210\",\n  \"displayName\": \"support line\",\n  \"terminationUri\": \"sip:pstn.example-carrier.in\",\n  \"authUsername\": \"silk\",\n  \"authPassword\": \"s3cret\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://silk-api.rumik.ai/v1/sip-trunks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phoneNumber\": \"+91 98765 43210\",\n  \"displayName\": \"support line\",\n  \"terminationUri\": \"sip:pstn.example-carrier.in\",\n  \"authUsername\": \"silk\",\n  \"authPassword\": \"s3cret\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "019f7c10-2b4e-7d5f-8a6b-7c8d9e0f1a2b",
  "phoneNumber": "+919876543210",
  "displayName": "support line",
  "terminationUri": "sip:pstn.example-carrier.in",
  "authUsername": "silk",
  "hasAuth": true,
  "originationUri": "sip:sip.silk.rumik.ai;transport=tcp",
  "assignedAgentId": null,
  "assignedAgentName": null,
  "status": "active",
  "createdAt": "2026-09-11T10:00:00Z",
  "updatedAt": "2026-09-11T10:00:00Z"
}

Authorizations

Authorization

string

header

required

your rumik api key, e.g. rk_live_.... create one in the rumik dashboard.

Body

application/json

phoneNumber

string

required

your number, an Indian mobile number in E.164 (+91…; spaces and dashes tolerated).

terminationUri

string

required

your carrier's SIP endpoint for outbound calls from this number: sip: / sips: scheme, optional user@, port and ;transport= params.

displayName

string | null

a label; defaults to the number.

authUsername

string | null

the digest username your carrier authenticates with. required.

authPassword

string | null

the digest password. required; never returned.

Response

created.

one of your own numbers registered on the platform.

string<uuid>

required

the trunk's id — fromTrunkId on POST /v1/calls.

phoneNumber

string

required

the number, E.164.

displayName

string

required

terminationUri

string

required

hasAuth

boolean

required

whether credentials are stored.

status

string

required

active.

createdAt

string<date-time>

required

updatedAt

string<date-time>

required

authUsername

string | null

originationUri

string | null

the SIP address your carrier must send inbound calls to.

assignedAgentId

string<uuid> | null

the agent answering the number, or null.

assignedAgentName

string | null

that agent's name.

curl --request POST \
  --url https://silk-api.rumik.ai/v1/sip-trunks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phoneNumber": "+91 98765 43210",
  "displayName": "support line",
  "terminationUri": "sip:pstn.example-carrier.in",
  "authUsername": "silk",
  "authPassword": "s3cret"
}
'

import requests

url = "https://silk-api.rumik.ai/v1/sip-trunks"

payload = {
    "phoneNumber": "+91 98765 43210",
    "displayName": "support line",
    "terminationUri": "sip:pstn.example-carrier.in",
    "authUsername": "silk",
    "authPassword": "s3cret"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    phoneNumber: '+91 98765 43210',
    displayName: 'support line',
    terminationUri: 'sip:pstn.example-carrier.in',
    authUsername: 'silk',
    authPassword: 's3cret'
  })
};

fetch('https://silk-api.rumik.ai/v1/sip-trunks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://silk-api.rumik.ai/v1/sip-trunks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'phoneNumber' => '+91 98765 43210',
    'displayName' => 'support line',
    'terminationUri' => 'sip:pstn.example-carrier.in',
    'authUsername' => 'silk',
    'authPassword' => 's3cret'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://silk-api.rumik.ai/v1/sip-trunks"

	payload := strings.NewReader("{\n  \"phoneNumber\": \"+91 98765 43210\",\n  \"displayName\": \"support line\",\n  \"terminationUri\": \"sip:pstn.example-carrier.in\",\n  \"authUsername\": \"silk\",\n  \"authPassword\": \"s3cret\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://silk-api.rumik.ai/v1/sip-trunks")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"phoneNumber\": \"+91 98765 43210\",\n  \"displayName\": \"support line\",\n  \"terminationUri\": \"sip:pstn.example-carrier.in\",\n  \"authUsername\": \"silk\",\n  \"authPassword\": \"s3cret\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://silk-api.rumik.ai/v1/sip-trunks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phoneNumber\": \"+91 98765 43210\",\n  \"displayName\": \"support line\",\n  \"terminationUri\": \"sip:pstn.example-carrier.in\",\n  \"authUsername\": \"silk\",\n  \"authPassword\": \"s3cret\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "019f7c10-2b4e-7d5f-8a6b-7c8d9e0f1a2b",
  "phoneNumber": "+919876543210",
  "displayName": "support line",
  "terminationUri": "sip:pstn.example-carrier.in",
  "authUsername": "silk",
  "hasAuth": true,
  "originationUri": "sip:sip.silk.rumik.ai;transport=tcp",
  "assignedAgentId": null,
  "assignedAgentName": null,
  "status": "active",
  "createdAt": "2026-09-11T10:00:00Z",
  "updatedAt": "2026-09-11T10:00:00Z"
}

documentation

sdk

integrations

cookbook

api reference

register a sip trunk

Authorizations

Body

Response