---
title: "Purchase and create a tracking number"
method: POST
path: "/api/call-tracking/numbers"
tags: ["Call Tracking"]
---

# Purchase and create a tracking number

`POST /api/call-tracking/numbers`

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.

## 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)