import { CommuneClient } from 'commune-ai';

const commune = new CommuneClient({ apiKey: process.env.COMMUNE_API_KEY });

const phoneNumber = await commune.phoneNumbers.purchase({
  number: '+18005550001',
  friendlyName: 'Support Line',
});

console.log(phoneNumber.id);      // pn_01abc123
console.log(phoneNumber.number);  // +18005550001

from commune import CommuneClient

client = CommuneClient()

phone_number = client.phone_numbers.purchase(
    number="+18005550001",
    friendly_name="Support Line",
)

print(phone_number.id)      # pn_01abc123
print(phone_number.number)  # +18005550001

purchase_phone_number(
  phone_number="+18005550001",
  friendly_name="Support Line"
)

curl -X POST https://api.commune.email/v1/phone-numbers \
  -H "Authorization: Bearer comm_..." \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+18005550001",
    "friendly_name": "Support Line"
  }'

commune phone-numbers purchase --number "+18005550001" --name "Support Line"

{
  "data": {
    "id": "pn_01abc123",
    "number": "+18005550001",
    "numberType": "tollfree",
    "friendlyName": "Support Line",
    "country": "US",
    "capabilities": {
      "sms": true,
      "mms": true,
      "voice": true
    },
    "status": "active",
    "allowList": [],
    "blockList": [],
    "creditCostPerMonth": 150,
    "autoReply": null,
    "createdAt": "2026-02-25T10:00:00.000Z",
    "updatedAt": "2026-02-25T10:00:00.000Z"
  }
}

{
  "error": "Invalid request",
  "details": {
    "fieldErrors": {
      "type": ["Invalid enum value. Expected 'local' | 'tollfree'"]
    }
  }
}

{
  "error": "insufficient_phone_credits",
  "message": "Purchasing a phone number costs 75 credits (prorated for 15 days remaining). Your balance is 50.",
  "required": 75,
  "balance": 50,
  "buy_url": "/dashboard/billing"
}

{
  "error": "us_local_a2p_required",
  "message": "US local numbers require A2P 10DLC campaign registration. Use toll-free numbers for now.",
  "a2p_status": "none"
}

{
  "error": "release_cooldown_active",
  "message": "You must wait 30 days after releasing a phone number before purchasing a new one."
}