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

# NLPearl Phone Numbers

> Learn how to purchase phone numbers directly from the NLPearl.AI platform.

<div className="block dark:hidden">
  <Frame>
    <div className="p-1">
      <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/nlpearl-phones-cover.svg?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=3cfbbaf2d816d09eb4660fb8ad48019f" alt="NLPearl Phone Numbers cover" className="rounded-[14px]" width="1048" height="720" data-path="images/dark_mode/nlpearl-phones-cover.svg" />
    </div>
  </Frame>
</div>

<div className="hidden dark:block">
  <Frame>
    <div className="p-1">
      <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/nlpearl-phones-cover.svg?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=3cfbbaf2d816d09eb4660fb8ad48019f" alt="NLPearl Phone Numbers cover" className="rounded-[14px]" width="1048" height="720" data-path="images/dark_mode/nlpearl-phones-cover.svg" />
    </div>
  </Frame>
</div>

NLPearl.AI allows you to purchase phone numbers directly from our platform to support your inbound and outbound call activities. These phone numbers are billed monthly and can be managed easily within your account.

<Card>
  ### Available Countries

  Currently, we offer phone numbers for purchase from the following country:

  | Country       | ISO Code | Status                                                                                                                                                      |
  | ------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | United States | `US`     | <span style={{ backgroundColor: '#28A948', color: 'white', padding: '4px 8px', borderRadius: '4px', fontWeight: '500', fontSize: '14px' }}>Available</span> |

  <Note>
    If you require phone numbers from other country codes, please consider using our [Twilio Integration](/pages/twilio_integration) or [Custom VoIP Integration](/pages/custom_voip) options.
  </Note>
</Card>

***

### Before You Purchase

<Info>
  **An active subscription is required.** Buying an NLPearl phone number is only available on a paid plan.
</Info>

Each phone number is billed monthly, and the exact per-number price is shown in the purchase panel next to each number. Numbers included in your plan appear as **Free with plan** in the cart (see [Payment and Billing](#payment-and-billing)).

<Warning>
  **Outbound calling & spam risk:** If you plan to make outbound calls, we strongly recommend integrating and verifying your number with a VoIP provider. Otherwise, carriers may flag it as spam.
</Warning>

***

### How to Purchase a Phone Number

Follow these steps to purchase a phone number from NLPearl.AI:

<Steps>
  <Step title="Go to Phone Numbers Settings">
    Start by clicking your **profile card** at the bottom-left corner of the sidebar, then open **Settings**.

    <Frame>
      <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/go-to-settings.png?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=dfc9db0b75112fe19e8e8212903ca193" alt="Open Settings from the profile card" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/go-to-settings.png" />
    </Frame>

    From there, open the **Phone Numbers** tab to manage or purchase phone numbers linked to your account.

    <Frame>
      <img src="https://mintcdn.com/nlpearl/zHQFKodWEnahK9ly/images/dark_mode/choose-phone-number-in-settings.png?fit=max&auto=format&n=zHQFKodWEnahK9ly&q=85&s=24c047eabb48b8ff854c0e7e56bfb678" alt="Phone Numbers tab in Settings" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/choose-phone-number-in-settings.png" />
    </Frame>
  </Step>

  <Step title="Click on Purchase NLPearl Phone Number">
    In the **Phone Numbers** tab, locate the **Purchase NLPearl Phone Number** button in the center of the screen.

    Click it to access the list of available phone numbers for purchase.

    <div className="block dark:hidden">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/nlpearl-phones-select-number.png?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=fbae7a28413d3517dae46fe221013600" alt="Send Email action interface on light mode" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/nlpearl-phones-select-number.png" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/nlpearl-phones-select-number.png?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=fbae7a28413d3517dae46fe221013600" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/nlpearl-phones-select-number.png" />
        </div>
      </Frame>
    </div>
  </Step>

  <Step title="Select Phone Numbers">
    Once you click **Purchase NLPearl Number**, a side panel titled **Purchase Phone Numbers** <span style={{ color: '#f87171', fontWeight: 600 }}>(1)</span> opens on the right.

    Here, you’ll see a list of available US phone numbers. To add a number to your cart, simply click the **Add** button next to it. When selected, the button turns green and updates to **Added** <span style={{ color: '#f87171', fontWeight: 600 }}>(2)</span>.

    <div className="block dark:hidden">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/nlpearl-phones-purchase-popup.png?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=de448c3f8b87b4a0e27ba504304eaa8c" alt="Send Email action interface on light mode" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/nlpearl-phones-purchase-popup.png" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/nlpearl-phones-purchase-popup.png?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=de448c3f8b87b4a0e27ba504304eaa8c" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/nlpearl-phones-purchase-popup.png" />
        </div>
      </Frame>
    </div>

    <Note>
      **Not finding a number you like?** You can refresh the list to generate a new selection of available phone numbers.

      <div className="block dark:hidden">
        <Frame>
          <div className="p-1">
            <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/nlpearl-phones-refresh-list.png?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=d1d207e37e323541e6e0c2e81beec983" alt="Send Email action interface on light mode" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/nlpearl-phones-refresh-list.png" />
          </div>
        </Frame>
      </div>

      <div className="hidden dark:block">
        <Frame>
          <div className="p-1">
            <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/nlpearl-phones-refresh-list.png?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=d1d207e37e323541e6e0c2e81beec983" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/nlpearl-phones-refresh-list.png" />
          </div>
        </Frame>
      </div>
    </Note>
  </Step>

  <Step title="Review Your Cart">
    Once you’ve selected your numbers, the **Cart Summary** on the right side of the **Purchase Phone Numbers** panel lists everything you’ve added.

    * Each row shows a number and its monthly **Amount**.
    * The **Total Due Today** (and the recurring monthly cost) updates automatically as you add or remove numbers.
    * To remove a number, click the **red delete icon** next to it.
    * Your saved **Payment Method** is shown at the bottom, just above the **Confirm Payment** button.

    <div className="block dark:hidden">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/nlpearl-phones-cart-summary.png?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=47beabe6c7fd1428f7eeaff269e62e13" alt="Send Email action interface on light mode" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/nlpearl-phones-cart-summary.png" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/nlpearl-phones-cart-summary.png?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=47beabe6c7fd1428f7eeaff269e62e13" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/nlpearl-phones-cart-summary.png" />
        </div>
      </Frame>
    </div>
  </Step>

  <Step title="Complete the Purchase">
    When you're happy with your selection, click the **Confirm Payment** button at the bottom of the Cart Summary to finalize your order. Your selected phone numbers will be instantly added to your account, ready to use without any delay.
  </Step>

  <Step title="Manage Your Phone Numbers">
    After purchasing, you can assign phone numbers directly to your **inbound** or **outbound campaigns** from the platform.

    To assign a phone number, open the settings of the specific campaign (inbound or outbound) and choose the number you'd like to attach.

    <div className="block dark:hidden">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/zHQFKodWEnahK9ly/images/dark_mode/choose-campaign-phone.png?fit=max&auto=format&n=zHQFKodWEnahK9ly&q=85&s=7e2a1e0f5a88eebafd31c322f8664f73" alt="Send Email action interface on light mode" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/choose-campaign-phone.png" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/zHQFKodWEnahK9ly/images/dark_mode/choose-campaign-phone.png?fit=max&auto=format&n=zHQFKodWEnahK9ly&q=85&s=7e2a1e0f5a88eebafd31c322f8664f73" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/choose-campaign-phone.png" />
        </div>
      </Frame>
    </div>

    <Warning>
      If a phone number is scheduled for deletion but still linked to an active campaign, that campaign will **automatically stop working** once the number is removed.
    </Warning>
  </Step>
</Steps>

<Card title="Deleting Phone Numbers" icon="circle-info" iconType="light">
  If you no longer need a phone number, you can schedule it for deletion directly from your settings.

  Start by going to the **Phone Numbers** section in your Settings. From there, locate the number you want to remove and click the **Delete** button next to it.

  <div className="block dark:hidden">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/zHQFKodWEnahK9ly/images/dark_mode/delete-phone-number.png?fit=max&auto=format&n=zHQFKodWEnahK9ly&q=85&s=cf16c9e0f645b89d1c7e2c150bfa9ec0" alt="Send Email action interface on light mode" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/delete-phone-number.png" />
      </div>
    </Frame>
  </div>

  <div className="hidden dark:block">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/zHQFKodWEnahK9ly/images/dark_mode/delete-phone-number.png?fit=max&auto=format&n=zHQFKodWEnahK9ly&q=85&s=cf16c9e0f645b89d1c7e2c150bfa9ec0" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/delete-phone-number.png" />
      </div>
    </Frame>
  </div>

  A confirmation step will appear to make sure you really want to delete the selected number. Once confirmed, the deletion is scheduled but not immediate.

  Once confirmed, the deletion will be scheduled but not immediate. The phone number remains active until its **billing anniversary date**, when it will be automatically removed from your account.

  <Info>
    You can continue using the number normally until that date. Deletion only takes effect on its billing anniversary.
  </Info>
</Card>

***

### Payment and Billing

Phone numbers are billed on a monthly basis, charged to the **credit card** saved on your account. Once the transaction is processed, you'll receive an invoice by email.

<Note>
  **Subscription Inclusions**: <br />
  If your plan includes phone numbers and you haven't used your allowance yet, those numbers appear as **Free with plan** in the cart, at no extra cost. If you add more numbers than your plan includes, use **Make this free** on a number to choose which one uses your included allowance.
</Note>

***

<Warning>
  ### Important Considerations

  * **Monthly Billing Cycle**: Phone numbers are billed on a monthly cycle starting from the date of purchase.
  * **Country Code Limitations**: Currently, only US phone numbers are available for direct purchase. For other countries, consider alternative integration options.
  * **Payment Method**: Keep a valid credit card on file to avoid interruptions in service.
</Warning>

***

<Card title="Need Phone Numbers from Other Countries?" icon="circle-info" iconType="light">
  <br />

  <CardGroup cols={2}>
    <Card title="Twilio Integration" icon="object-intersect" iconType="light" href="/pages/twilio_integration">
      Explore our **Twilio Integration** to access a broader range of international phone numbers.
    </Card>

    <Card title="Custom VoIP Integration" icon="code-branch" iconType="light" href="/pages/custom_voip">
      Consider the **Custom VoIP Integration** if you have specific VoIP services you wish to use.
    </Card>
  </CardGroup>
</Card>
