Skip to main content
POST
/
v1
/
phone-numbers
Create Phone Number
curl --request POST \
  --url https://api.sigmamind.ai/v1/phone-numbers \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "friendlyName": "My Phone Number",
  "countryCode": "US",
  "areaCode": 415,
  "phoneNumber": 14155552671,
  "inboundAgentId": "awTw7UKhOsLGiDbt",
  "outboundAgentId": "awTw7UKhOsLGiDbt",
  "outboundPhoneNumber": 14155552671
}
'
{
  "sipPhoneNumber": 14155552671,
  "provider": "twilio",
  "inboundAgentId": "D5D0p7TUs66TTAEAx",
  "outboundAgentId": "D5D0p7TUs66TTAEAx",
  "outboundPhoneNumber": 14155552671,
  "active": true,
  "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
​
friendlyName
string

A user-friendly label for the phone number.

Example:

"My Phone Number"

​
countryCode
string

The ISO country code (e.g., 'US', 'IN') indicating the country from which the number should be purchased. Required if phoneNumber is not provided.

Example:

"US"

​
areaCode
integer<int32>

The area/region code within the specified country from which the number should be purchased.

Example:

415

​
phoneNumber
string

The phone number to purchase, in E.164 format (e.g., +14155552671). If provided, this exact number will be purchased if available with the provider. If omitted, a number is automatically selected based on countryCode (and areaCode, if specified).

Example:

14155552671

​
inboundAgentId
string

The inbound AI agent ID to be associated with this phone number.

Example:

"awTw7UKhOsLGiDbt"

​
outboundAgentId
string

The outbound AI agent ID to be associated with this phone number.

Example:

"awTw7UKhOsLGiDbt"

​
outboundPhoneNumber
string

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

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

​
provider
enum<string>

The service provider associated with the phone number.

Available options:
twilio, telnyx, byo
Example:

"twilio"

​
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

​
friendlyName
string

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

Example:

"Support Line - US"