---
title: "Subscribe to phone numbers (purchase tracking numbers)"
method: POST
path: "/api/phone/subscribe"
tags: ["Phone Subscription"]
---

# Subscribe to phone numbers (purchase tracking numbers)

`POST /api/phone/subscribe`

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

## Headers

- `x-api-token` string, nullable

## Request body

- object

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)