---
title: "Assign Number"
method: POST
path: "/v1/accounts/{account_id}/numbers"
---

# Assign Number

`POST /v1/accounts/{account_id}/numbers`

## Request

- Base URL: `https://api.textforagents.com`
- URL: `https://api.textforagents.com/v1/accounts/{account_id}/numbers`
- Auth: none declared

Just-in-time assignment: take the oldest available pool
number, or have the provisioning provider order one on
demand. An empty pool with no provider configured is an
honest 503 — numbers are never invented.

## Path parameters

- `account_id` string, required

## Headers

- `authorization` string, nullable

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/textforagents/apis/textforagents-api.md) · [All operations](https://skmtc.dev/textforagents/apis/textforagents-api/llms.txt) · [OpenAPI document](https://skmtc.dev/textforagents/apis/textforagents-api/revisions/9306ab0e457b?raw)