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

> Phone Numbers are the caller ID for AI phone/voice outreach and the from number for SMS to candidates.

# Phone Numbers

Managing them here keeps **trust** high (familiar area codes) and makes sure **SMS blasts** and **phone steps** have a valid line to send from.

<Frame>
  <Frame>
    <img src="https://mintcdn.com/heymilo/Gyo-A8qBjtIkO2AA/images/image-91.png?fit=max&auto=format&n=Gyo-A8qBjtIkO2AA&q=85&s=06644306bab524d1604a4b59356226c8" alt="Image" width="1520" height="795" data-path="images/image-91.png" />
  </Frame>
</Frame>

**Path:** **Sidebar → Outreach → Phone Numbers**

### Why it matters

* **Answer rates**: Local or recognizable numbers get more pickups than random long-distance codes.
* **SMS delivery**: You need a **workspace number** (and compliance setup) before high-volume text works reliably.
* **Visibility**: You can see **which interviewers or qualifiers** use each number so you don’t double-book or delete something still in use.

### How it works

1. **Provision** a number through **HeyMilo / support** (the product expects you to **get a valid number from the team** first - usually your dedicated CS Manager).
2. **Register** it in the app in **E.164** format (e.g. `+12062088075`).
3. **Attach** numbers when you configure **SMS** or **phone** interview steps (and related flows)—exact pickers live on the **interviewer / posting** side.
4. **Monitor** usage badges on this page; **deactivate** or **delete** when safe.

### Add / register a number

1. Open **Outreach → Phone Numbers**.
2. **Add Number**.

<Frame>
  <img src="https://mintcdn.com/heymilo/khmklczV5WPXMedr/images/Screenshot%202026-03-20%20at%2012.01.27%E2%80%AFPM.png?fit=max&auto=format&n=khmklczV5WPXMedr&q=85&s=a2fa7cbaf73d9e8aa356787e8f508990" className="mx-auto" style={{ width:"82%" }} width="1182" height="712" data-path="images/Screenshot 2026-03-20 at 12.01.27 PM.png" />
</Frame>

3. Read the prompt: you typically **contact support** to obtain a provisioned number, then **register** it here.
4. Enter the number in **E.164**: leading `+`, country code, then digits (**no** spaces or dashes in the stored value unless the UI strips them—use the format the field validates).
5. **Register**.

If registration fails, check the error text—**invalid format** usually means not true E.164.

### What you see on the list

For each number you’ll typically see:

* **Formatted display** (easier to read than raw E.164)
* **Country** (when available)
* **Created / provisioned** timing
* **Status**, **Active** or **Inactive**
* **Usage**, for example:
  * **Available**: Not tied to active consumers (or no usage recorded)
  * **Agents**: In use by one or more **interviewers/postings** (count shown; click through for detail)
  * **Reserved / Qualifier**: Held for an **inbound qualifier** (or similar) so it’s not free for other use

Use **View all usage** (or the usage chips) to open **where** the number is wired—often with links to the **posting** or **qualifier**.

### Manage a number (⋮ menu)

<Frame>
  <img src="https://mintcdn.com/heymilo/khmklczV5WPXMedr/images/Screenshot%202026-03-20%20at%2012.03.54%E2%80%AFPM.png?fit=max&auto=format&n=khmklczV5WPXMedr&q=85&s=84fe139f50b261883114796ed26b123d" className="mx-auto" style={{ width:"65%" }} width="458" height="292" data-path="images/Screenshot 2026-03-20 at 12.03.54 PM.png" />
</Frame>

* **Set to Inactive**: Stops using it as an active line while keeping the record (confirm what this does for in-flight campaigns in your workspace).
* **Activate**: Turn an inactive number back on.
* **Delete**: Remove the number from the workspace. **You usually cannot delete** a number that still has **active** usage on postings or qualifiers; reassign or deactivate those first.

### Best practices

* **Ask support for the right region** when you care about **local presence** for your candidate pool.
* **One number per high-volume brand** if you white-label or run multiple clients—avoids cross-client confusion.
* **Before deleting**, open **usage** and clear or reassign every **agent** and **qualifier** reference.

### Troubleshooting

| Issue                       | What to check                                                                |
| --------------------------- | ---------------------------------------------------------------------------- |
| **Can’t register**          | E.164 only (`+` and digits); number actually provisioned for your workspace. |
| **Delete disabled / error** | Number still **in use**—open usage, remove from postings/qualifier.          |
| **No numbers at all**       | Empty state tells you to **contact support** to provision the first line.    |
| **SMS blast problems**      | Contact Blasts, candidate opt-in/history, and this page’s **active** status. |

### Next steps

* [Contact Blasts](contact-blasts-1) — Bulk SMS (and related limits)
* [Email Templates](contact-blasts) — Parallel track for automated email
* [Outreach](.) — Sender domains, custom domains, branding
* [Interview types](../../getting-started/log-in/interview-types) — Voice vs SMS in the workflow

**Help:** In-app **Contact Support** on the Phone Numbers page, or [**support@heymilo.ai**](mailto:support@heymilo.ai).