Phone Subscription

Subscribe to phone numbers (purchase tracking numbers)

Subscribe to one or more phone numbers (purchase tracking numbers).

Purchases numbers from Telnyx, charges immediately, and creates monthly usage entries.

Request body:

  • phone_numbers: List of phone numbers to purchase (e.g., ["+351256259001", "+351256259002"])
  • team_id: Team ID to assign the numbers to
  • forward_to: Number to forward calls to
  • idpointofsale: (Optional) PV ID for billing (defaults to team's PV)

Returns:

  • subscribed: List of successfully purchased numbers
  • failed: List of numbers that failed to purchase
  • already_subscribed: List of numbers already owned
post/api/phone/subscribe

Headers

x-api-tokenstring nullable

Request body

object required

Response

Successful Response

object required

Changes

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