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

# Purchase Outbound number

> Purchase and configure a new inbound phone number. ($15/mo. subscription using your stored payment method).

### Headers

<ParamField header="authorization" type="string" required={true}>
  Your API key for authentication.
</ParamField>

### Body

<ParamField body="area_code" type="string" default="415">
  Choose a three-digit area code for your phone number. If set as a parameter, a number will only be purchased by exact match if available.
</ParamField>

### Response

<ResponseField name="phone_number" type="string">
  The created phone number, will be in the following format: `+1XXXXXXXXXX`

  Example: `+18582814611`
</ResponseField>

<ResponseExample>
  ```json Response
  {
    "phone_number": "+18582814611"
  }
  ```
</ResponseExample>