> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Provision a Phone Number

> This operation lets you provision a phone number for the authenticated Nexor account. This reference documents verified path, query, and top-level JSON body fields, observed response status codes, and top-level response fields. Provider-owned or deeply nested response shapes may remain open.

<Warning>
  **Safety and behavior notes**

  * The client cap is one included number plus paid slots, with a higher operations override.
  * Acquiring a number from the external carrier can start recurring provider billing.
  * If phone\_number is omitted and the pool is empty, the downstream purchase path receives no specific number and no test defines a successful fallback.
  * The mutation returns a broad provider record that can include internal columns and does not have a stable public projection.
  * Do not send sms\_workflow\_id. The published request intentionally omits it because the runtime does not tenant-validate that field.
  * The effective default allowance is one included number plus paid extra slots; do not assume a default of three.
</Warning>


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.getnexor.ai/llms.txt).