---
title: "Import Phone Number"
method: POST
path: "/v1/phone-numbers/import"
---

# Import Phone Number

`POST /v1/phone-numbers/import`

Imports a phone number from your own SIP trunk provider. This allows you to use existing phone numbers with telli by configuring custom SIP termination settings.

## Request body

- object
  - `phoneNumber` string, required — Phone number in E.164 format (e.g. +4917642048466)
  - `terminationUri` string, required — SIP termination URI for routing calls
  - `authUsername` string, required — Username for SIP authentication
  - `authPassword` string, required — Password for SIP authentication
  - `transport` 'TCP' | 'UDP' | 'TLS' — SIP transport protocol for the imported number. Defaults to TCP.
  - `inOutboundPool` boolean — Whether to include this phone number in the outbound call pool. Defaults to true.

## Response `200`

Phone number imported successfully

- PhoneNumber
  - `type` 'PhoneNumber' — Resource type identifier
  - `id` string, uuid — Unique identifier for the phone number
  - `phoneNumber` string — Phone number in E.164 format (e.g. +4917642048466)
  - `inOutboundPool` boolean — Whether this phone number is available for outbound calls
  - `phoneNumberType` 'local' | 'mobile' | 'null', nullable — Type of phone number (local or mobile)
  - `createdAt` string, date-time — When the phone number was added to the account

## Other responses

- `400` — Invalid request
- `401` — Unauthorized - Invalid API key

---

[API](https://skmtc.dev/telli/apis/telli-api.md) · [All operations](https://skmtc.dev/telli/apis/telli-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/telli/telli-api/revisions/9815a3c63c75/schema)