Purchase number

Purchases a phone number that was returned by the search endpoint. The platform handles pricing, billing, and provisioning automatically.

You must have a valid payment method on file before purchasing. The purchase creates a monthly subscription that auto-renews.

Endpoint

POST /user/phone-numbers/purchase

Request

string

required

Phone number to purchase in E.164 format (e.g., +14155551234). Must be a number returned from the search endpoint.

Response

string

Confirmation message.

object

The purchased phone number details.

Show properties

integer

Unique identifier of the phone number.

string

Phone number in E.164 format.

string

ISO country code.

string

Phone number type — always normal for purchased numbers.

boolean

Whether the number supports SMS.

Example

curl -X POST "https://portal.intellixent.ai/api/user/phone-numbers/purchase" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number": "+14155551234"}'

const response = await fetch('https://portal.intellixent.ai/api/user/phone-numbers/purchase', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ phone_number: '+14155551234' })
});

const data = await response.json();
console.log(data.data.id); // New phone number ID

201 Created

{
  "message": "Phone number purchased successfully.",
  "data": {
    "id": 123,
    "phone_number": "+14155551234",
    "country_code": "US",
    "type": "normal",
    "sms_capable": true
  }
}

402 No payment method

{
  "error": "No payment method found. Please add a payment method to your account."
}

400 Already in use

{
  "error": "This phone number is already in use."
}

Purchases are non-refundable. The subscription continues until you release the number.

Overview

Assistants

Calls

Campaigns & Leads

Conversations

Messaging

Phone Numbers

Knowledge & Tools

Webhooks

Endpoint

Request

Response

Example

​Endpoint

​Request

​Response

​Example

Endpoint

Request

Response

Example