Phone Provisioning
Phone Provisioning

Purchase Number

Purchase a phone number from Telnyx, charge user, bind to their account.

Security rules:

  • User must have made at least one paid top-up (not just signup bonus). Trial users cannot spend their bonus on number rentals.
  • Balance must cover upfront charge.
  • Only allowed countries (platform_settings.telnyx_allowed_countries).
post/v1/numbers/purchase

Request

  • Base URL: https://api.call2me.app
  • URL: https://api.call2me.app/v1/numbers/purchase
  • Auth: HTTP bearer

Request body

phone_numberstring required

E.164 format, e.g., +12125551234

agent_idstring nullable

Agent to bind (optional)

providerstring nullable

telnyx | twilio (auto by country if omitted)

Response

Successful Response

successboolean required
phone_numberstring required
order_idstring required
monthly_price_usdnumber required
balance_after_usdnumber required
messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.