Create a SIP trunk
Connects a carrier trunk or office phone system over SIP, by IP, digest or registration, with the numbers on it. The connection is set up and checked straight away; check status. Passwords are never returned.
Scopes: number:write
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
A unique key (a UUID works) for this request. Retrying with the same key returns the first answer instead of running twice.
255The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Body
1 - 80^(carrier|pbx)$402551 <= x <= 65535^(udp|tcp)$^(ip|digest|register)$120200255^(e164|digits)$^[0-9#*]{0,10}$10646^(rfc4733|inband|info|auto)$^(off|sdes)$200Response
Successful Response
The connection id.
Its name.
carrier or pbx.
Its name on our SIP edge.
Extra X- headers we send.
Where your calls come from.
Audio codecs, in order.
ISO 8601.
Kallabot looks after it for numbers bought here; it can't be edited.
Its numbers.
The carrier preset used.
Where we send calls.
Its SIP port.
udp or tcp.
ip, digest or register.
The SIP username.
The last characters of the password.
The From domain we send.
e164 or digits.
Digits put before every dialled number.
How keypresses are sent.
off or sdes.
The last check's result.
The check in plain words.
When it was last checked.