> ## 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/DSJnNLmkdffV1qq-/images/light_mode/phone_number_nlpearl-cover.png?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=091d4d40083b7dbdd0cb55686f87f7ea" alt="Send Email action interface on light mode" className="rounded-[14px]" width="6000" height="2000" data-path="images/light_mode/phone_number_nlpearl-cover.png" />
    </div>
  </Frame>
</div>

<div className="hidden dark:block">
  <Frame>
    <div className="p-1">
      <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/phone_number_nlpearl-cover.png?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=dbcc3106d7205450b9429dd7cc2efd06" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="6000" height="2000" data-path="images/dark_mode/phone_number_nlpearl-cover.png" />
    </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>

***

### 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** <span style={{ color: '#f87171', fontWeight: 600 }}>(1)</span> at the bottom-left corner of the sidebar. This opens the Settings panel.

    From there, go to the **Phone Numbers tab** <span style={{ color: '#f87171', fontWeight: 600 }}>(2)</span> to manage or purchase phone numbers linked to your account.

    <div className="block dark:hidden">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/DSJnNLmkdffV1qq-/images/light_mode/phone_number_tab.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=b07ae17b8961515657dbc4a11b3df9f1" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2624" height="1456" data-path="images/light_mode/phone_number_tab.jpg" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/phone_number_tab.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=ea8dbbd01d61f0c0f2e3e852f54b20cf" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2624" height="1456" data-path="images/dark_mode/phone_number_tab.jpg" />
        </div>
      </Frame>
    </div>
  </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/DSJnNLmkdffV1qq-/images/light_mode/phone_number_purchasephonenumber.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=ed305c18d2ed7a36934a3f8249e5bb5b" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2624" height="1456" data-path="images/light_mode/phone_number_purchasephonenumber.jpg" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/phone_number_purchasephonenumber.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=b422de735373849252fb863cdb7e560b" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2624" height="1456" data-path="images/dark_mode/phone_number_purchasephonenumber.jpg" />
        </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/DSJnNLmkdffV1qq-/images/light_mode/phone_number_nlpearl-list.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=b105b36da403f10f20d53e49b2e2743b" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2624" height="1456" data-path="images/light_mode/phone_number_nlpearl-list.jpg" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/phone_number_nlpearl-list.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=1a9fa34c7bc24f037d1bb637ee52896f" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2624" height="1456" data-path="images/dark_mode/phone_number_nlpearl-list.jpg" />
        </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/DSJnNLmkdffV1qq-/images/light_mode/phone_number_nlpearl-refresh.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=42ce50ae05543a310e1458d40927770a" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2624" height="1456" data-path="images/light_mode/phone_number_nlpearl-refresh.jpg" />
          </div>
        </Frame>
      </div>

      <div className="hidden dark:block">
        <Frame>
          <div className="p-1">
            <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/phone_number_nlpearl-refresh.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=48d3dfb5eeaf656bc97025226f6be009" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2624" height="1456" data-path="images/dark_mode/phone_number_nlpearl-refresh.jpg" />
          </div>
        </Frame>
      </div>
    </Note>
  </Step>

  <Step title="Review Your Cart">
    Once you’ve selected your numbers, scroll to the bottom of the **Purchase Phone Numbers** panel to access your **Cart**.

    There, you’ll see the phone numbers you’ve added, along with the monthly pricing details.

    * To remove a number, click the **red delete icon** next to it.
    * The **Total** cost is automatically updated based on your selections.

    <div className="block dark:hidden">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/DSJnNLmkdffV1qq-/images/light_mode/phone_number_cart.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=a7de15b2bd4481cbeb9c90ba12aa6b00" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2624" height="1456" data-path="images/light_mode/phone_number_cart.jpg" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/phone_number_cart.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=db749a58f0a83f32b034753788f97fe1" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2624" height="1456" data-path="images/dark_mode/phone_number_cart.jpg" />
        </div>
      </Frame>
    </div>
  </Step>

  <Step title="Complete the Purchase">
    When you're happy with your selection, click the **Purchase** button at the bottom of the panel 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/DSJnNLmkdffV1qq-/images/light_mode/phone_number_campaign.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=ab82e367ad00274b82061504ffe76ed3" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2986" height="1144" data-path="images/light_mode/phone_number_campaign.jpg" />
        </div>
      </Frame>
    </div>

    <div className="hidden dark:block">
      <Frame>
        <div className="p-1">
          <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/phone_number_campaign.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=2037143d5b3dbf958643e7052b296cc7" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2986" height="1144" data-path="images/dark_mode/phone_number_campaign.jpg" />
        </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/DSJnNLmkdffV1qq-/images/light_mode/phone_number_delete.jpg?fit=max&auto=format&n=DSJnNLmkdffV1qq-&q=85&s=a5d80cb0e04575a1e289083410ea3850" alt="Send Email action interface on light mode" className="rounded-[14px]" width="2624" height="1456" data-path="images/light_mode/phone_number_delete.jpg" />
      </div>
    </Frame>
  </div>

  <div className="hidden dark:block">
    <Frame>
      <div className="p-1">
        <img src="https://mintcdn.com/nlpearl/OLkkXJCUYovrG0y1/images/dark_mode/phone_number_delete.jpg?fit=max&auto=format&n=OLkkXJCUYovrG0y1&q=85&s=c2f47eec60b829c8d8d8f7491babcccf" alt="Send Email action interface on dark mode" className="rounded-[14px]" width="2624" height="1456" data-path="images/dark_mode/phone_number_delete.jpg" />
      </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. There are two types of payment methods:

| Method          | Description                                                                                                                                                                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Credit**      | If you have enough credits available in your NLPearl account, phone numbers will be **automatically purchased using those credits**. The total cost will simply be deducted from your current credit balance — no additional action needed. |
| **Credit Card** | If your credit balance is **insufficient**, the system will automatically switch to your **saved credit card** to complete the purchase. Once the transaction is processed, you'll receive an invoice by email.                             |

<Note>
  **Subscription Inclusions**: <br />
  If your subscription plan includes phone numbers and you have not yet used your included allowance, the purchase will be free for the number of phone numbers included in your plan.
</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 Methods**: Ensure your account has sufficient credits or 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>
