Skip to main content
POST
/
assistants
/
v1
/
numbers
/
purchase
Purchase Number
curl --request POST \
  --url https://api-prod.interactly.ai/assistants/v1/numbers/purchase \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "number": "+1234567890"
}
'
{
  "_id": "a12f9c88-c155-461f-9771-4d240cdc9a04",
  "teamId": "1f7b1b1b1b1b1b1b1b1b1b1b",
  "number": "+1234567890",
  "provider": {
    "name": "twilio"
  },
  "assistantId": "a12f9c88-c155-461f-9771-4d240cdc9a04",
  "inboundEnabled": true,
  "outboundEnabled": true,
  "label": "friendly-name-1"
}

Authorizations

​
Authorization
string
header
required

Retrieve your API Key from Dashboard API Keys Section.

Body

application/json
​
number
string

Phone number to purchase. Please provide in E.164 format, Ex: +1234567890

Example:

"+1234567890"

Response

Successfully purchased the number.

​
_id
string<objectId>
required

Unique identifier of the number

Example:

"a12f9c88-c155-461f-9771-4d240cdc9a04"

​
teamId
string<objectId>
required

This is unique identifier of the team.

Example:

"1f7b1b1b1b1b1b1b1b1b1b1b"

​
number
string
required

Phone number associated with the team

Example:

"+1234567890"

​
provider
object
required
​
assistantId
string

ID of the associated assistant (if any)

Example:

"a12f9c88-c155-461f-9771-4d240cdc9a04"

​
inboundEnabled
boolean

If true, inbound call is enabled. If false, inbound call is disabled.

Example:

true

​
outboundEnabled
boolean

If true, outbound call is enabled. If false, outbound call is disabled.

Example:

true

​
label
string

Label for the number

Example:

"friendly-name-1"