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

# Setting up your phone number

> Purchase and configure a phone number in HoopAI to enable calling and SMS, then complete A2P 10DLC registration.

A phone number is required to send SMS messages and make calls through HoopAI. You purchase the number directly inside the platform — no external provider needed. After purchasing, completing A2P 10DLC registration unlocks bulk SMS sending.

<Frame caption="Phone Numbers settings — your purchased numbers and their configuration">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/dif11QvMekN9AcKH/images/settings-phone-numbers.png?fit=max&auto=format&n=dif11QvMekN9AcKH&q=85&s=50172bccb69bcce35a64a24f44bf96ee" alt="Phone numbers settings" width="1596" height="634" data-path="images/settings-phone-numbers.png" />
</Frame>

## Step 1 — Purchase a phone number

<Steps>
  <Step title="Go to Settings > Phone Numbers">
    Click **Settings** in the left sidebar and select **Phone Numbers**.
  </Step>

  <Step title="Click Add Number">
    Click **Add Number** or the **+** button to open the number purchase flow.
  </Step>

  <Step title="Choose country and number type">
    Select your country. Then choose between a **local** number (a regional area code) or a **toll-free** number (e.g., 1-800).

    <Tip>
      Local numbers typically have higher answer rates from contacts who recognise the area code. Toll-free numbers can be useful for national brands.
    </Tip>
  </Step>

  <Step title="Search by area code">
    Enter your desired area code to see available numbers. Select one and click **Buy** to complete the purchase.
  </Step>
</Steps>

***

## Step 2 — Configure your number

After purchasing, click the number to open its settings.

<Frame caption="Phone number configuration — name, forwarding, and call settings">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/dif11QvMekN9AcKH/images/settings-phone-configure.png?fit=max&auto=format&n=dif11QvMekN9AcKH&q=85&s=13c198100c89bf480c818d978107c7d6" alt="Phone number configure" width="1599" height="641" data-path="images/settings-phone-configure.png" />
</Frame>

Key settings to configure:

| Setting           | Description                                                                          |
| ----------------- | ------------------------------------------------------------------------------------ |
| Name              | A label for the number (e.g., "Main Sales Line") — internal only                     |
| Forwarding number | A personal or office phone to forward incoming calls when needed                     |
| Caller ID pass    | Shows your HoopAI number (not your forwarding number) as the outbound caller ID      |
| Call connect      | Requires a keypress before connecting forwarded calls — reduces robocall connections |
| Whisper message   | Plays a brief audio clip to you before connecting a forwarded call                   |
| Call recording    | Automatically records all calls on this number                                       |

***

## Step 3 — Configure voice call settings

Go to the **Voice Calls** tab within phone settings to configure:

* **Inbound call routing** — which user or team receives incoming calls
* **Voicemail greeting** — the message callers hear when no one answers
* **Business hours** — restrict when inbound calls ring through

<Frame caption="Voice call settings — inbound routing and voicemail configuration">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/dif11QvMekN9AcKH/images/settings-phone-voice-calls.png?fit=max&auto=format&n=dif11QvMekN9AcKH&q=85&s=59a959fb47b3f3551b5c8757adc68264" alt="Voice call settings" width="1170" height="408" data-path="images/settings-phone-voice-calls.png" />
</Frame>

***

## Step 4 — Complete A2P 10DLC registration

A2P 10DLC is a US carrier requirement for businesses sending SMS messages. Without registration, carriers will filter or block your outbound SMS.

<Warning>
  A2P 10DLC registration is mandatory for all US SMS. Start this immediately after purchasing your number — approval typically takes 1–5 business days.
</Warning>

Go to **Settings > Trust Center** to begin registration. You will need:

* Your legal business name (exactly as registered)
* EIN / Tax ID
* Business website URL
* Business type (LLC, Corporation, Sole Proprietor, etc.)
* A description of how you will use SMS

[Full A2P 10DLC registration guide →](/academy/onboarding/a2p-10dlc-registration)

***

## Using multiple phone numbers

You can purchase additional numbers for different purposes — for example, a separate number per team member, or a dedicated number for each marketing campaign. Each number has independent call and SMS settings.

<Tip>
  When using the dialer, you can choose which number to call from using the **From** dropdown — useful if you have multiple numbers assigned to your account.
</Tip>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What does a phone number cost?">
    Local US and Canadian numbers are typically a low monthly fee (around \$1–2/month) plus per-minute and per-message usage charges. Toll-free numbers are slightly higher. Pricing is shown during the purchase flow. Check your HoopAI plan details for included credits.
  </Accordion>

  <Accordion title="Can I port my existing business number to HoopAI?">
    Yes — number porting is available. Contact HoopAI support to initiate a port request. The process typically takes 2–4 weeks and requires a Letter of Authorization (LOA) from your current carrier.
  </Accordion>

  <Accordion title="Do I need A2P registration for 1-on-1 SMS in conversations?">
    A2P 10DLC is primarily required for bulk/campaign SMS. Low-volume 1-on-1 conversational SMS may work without full registration initially, but carriers can still filter unregistered traffic. Complete registration promptly to ensure reliable delivery for all SMS.
  </Accordion>

  <Accordion title="What if my A2P registration is rejected?">
    Rejections are usually due to incomplete business information or a mismatch between your legal name and EIN records. Review the rejection reason in **Settings > Trust Center** and resubmit with corrected information. Contact HoopAI support if you need help resolving a rejection.
  </Accordion>

  <Accordion title="Can I send SMS internationally?">
    Yes — international SMS is supported for many countries. Purchase or use an existing number that supports international sending, and ensure the contact's phone number includes the correct country code. Additional per-message rates apply for international destinations.
  </Accordion>
</AccordionGroup>
