v51

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-02172186551.1 KB

Purchase a phone number

Purchase an available phone number. The first US phone number is free for each team.

post/v1/phone-numbers

phoneNumberstring required

Phone number in E.164 format.

namestring

Optional custom name for the phone number.

{
  "phoneNumber": "+15551234567"
}

Phone number purchased successfully.

{
  "phoneNumber": {
    "phoneNumber": "+15551234567",
    "capabilities": [
      "sms",
      "voice"
    ]
  }
}