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

# Aprovisionar un número telefónico

> Esta operación permite aprovisionar un número telefónico en la cuenta autenticada de Nexor. Esta referencia documenta campos verificados de ruta, consulta y cuerpo JSON de nivel superior, códigos de estado observados y campos de respuesta de nivel superior. Las respuestas del proveedor o con estructuras anidadas profundas pueden permanecer abiertas.

<Warning>
  **Notas de seguridad y comportamiento**

  * El límite del cliente es un número incluido más los cupos pagados, con una excepción superior para operaciones.
  * Adquirir un número del operador externo puede iniciar facturación recurrente del proveedor.
  * Si se omite phone\_number y el pool está vacío, la compra posterior no recibe un número específico y ninguna prueba define un fallback exitoso.
  * La mutación devuelve un registro amplio del proveedor que puede incluir columnas internas y no tiene una proyección pública estable.
  * No envíes sms\_workflow\_id. La solicitud publicada lo omite de forma intencional porque el runtime no valida ese campo por tenant.
  * La asignación predeterminada efectiva es un número incluido más los cupos adicionales pagados; no asumas un valor predeterminado de tres.
</Warning>


## API Specification

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