Purchase and create a tracking number

Purchase a phone number from Telnyx and create a tracking number.

Required fields:

• phone_number: The phone number to purchase (E.164 format)
• source: Lead source label (e.g., "standvirtual", "website")
• team_id: Team ID - calls will ring team members (required)

Optional fields:

• idpointofsale: Point of sale ID for billing (defaults to user's PV or team's PV)

Status codes:

• 201: Number purchased and active.
• 202: Order accepted but still pending at Telnyx; a webhook will finalise later. Response shape: {status: "pending", order_id, phone_number}. No credits are deducted yet — the webhook handler charges on success.
• 409: An active tracking row already exists for this phone_number.
• 502: Telnyx rejected the order outright.