Skip to main content
POST
/
v1
/
phone-numbers
/
import
Import Phone Number
curl --request POST \
  --url https://api.sigmamind.ai/v1/phone-numbers/import \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "phoneNumber": "+14155552671",
  "trunkUsername": "username",
  "trunkPassword": "password",
  "terminationSipURI": "sip.telnyx.com",
  "friendlyName": "My Phone Number",
  "inboundAgentId": "awTw7UKhOsLGiDbt",
  "outboundAgentId": "awTw7UKhOsLGiDbt",
  "outboundPhoneNumber": "+14155552671"
}
'
{
  "sipPhoneNumber": "+14155552671",
  "inboundAgentId": "D5D0p7TUs66TTAEAx",
  "outboundAgentId": "D5D0p7TUs66TTAEAx",
  "outboundPhoneNumber": "+14155552671",
  "active": true,
  "terminationSipURI": "sip.telnyx.com",
  "friendlyName": "Support Line - US"
}

Authorizations

​
X-API-Key
string
header
required

API Key is required in header. You can find it in the settings

Body

application/json
​
phoneNumber
string
required

The phone number in E.164 format. Required when importing your own number.

Pattern: ^\+[1-9][0-9]{6,14}$
Example:

"+14155552671"

​
trunkUsername
string
required

The trunk username for outbound calls. Must be set up in your provider account.

Maximum string length: 128
Example:

"username"

​
trunkPassword
string
required

The trunk password for outbound calls. Must be set up in your provider account.

Maximum string length: 128
Example:

"password"

​
terminationSipURI
string
required

The SIP URI for terminating calls, provided by the telecom provider.

Maximum string length: 253
Example:

"sip.telnyx.com"

​
friendlyName
string

A user-friendly label for the phone number.

Maximum string length: 128
Example:

"My Phone Number"

​
inboundAgentId
string

The inbound AI agent ID to associate with this phone number.

Maximum string length: 64
Example:

"awTw7UKhOsLGiDbt"

​
outboundAgentId
string

The outbound AI agent ID to associate with this phone number.

Maximum string length: 64
Example:

"awTw7UKhOsLGiDbt"

​
outboundPhoneNumber
string

The outbound phone number in E.164 format, used for test calls.

Pattern: ^\+[1-9][0-9]{6,14}$
Example:

"+14155552671"

Response

OK

​
sipPhoneNumber
string

The caller’s phone number in E.164 format. This number must be obtained from SigmaMind or configured using SIP trunking with SigmaMind.

Example:

"+14155552671"

​
inboundAgentId
string

Default agent ID assigned to handle inbound calls for this phone number.

Example:

"D5D0p7TUs66TTAEAx"

​
outboundAgentId
string

Default agent ID assigned to handle outbound calls for this phone number.

Example:

"D5D0p7TUs66TTAEAx"

​
outboundPhoneNumber
string

The default outbound phone number of the callee, represented in E.164 format

Example:

"+14155552671"

​
active
boolean

Indicates whether the phone number is currently active and available for use.

Example:

true

​
terminationSipURI
string

The SIP URI of the phone number, provided by the service provider for call termination.

Example:

"sip.telnyx.com"

​
friendlyName
string

A user-friendly display name assigned to this phone number.

Example:

"Support Line - US"