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

> ## Agent Instructions
> Use the public API base URL: https://api.teamfollowup.ai/api.
> Authenticate public API requests with Authorization: Bearer YOUR_API_KEY.
> Use product-owned terms: agents, campaigns, projects (GoHighLevel sub-accounts), contacts, calls, outcomes, skills, cadences, phone numbers.
> Scope requests by locationId rather than projectName.
> Read the guide linked from each API reference group before recommending an endpoint.

# Phone Numbers API

> Search, buy, attach, assign, move and release the numbers your campaigns dial from, across the agency pool or scoped to one agent.

Every campaign dials from numbers your agency owns. Concepts are in
[Phone numbers and caller ID](/phone-numbers/overview).

Across the agency pool:

| Endpoint                                                                    | Use it to                                                                       |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| [List phone numbers](/api-reference/phone-numbers/list-phone-numbers)       | Every number you own, with `source`, `monthlyChargeUSD` and `campaigns[]`.      |
| [Search phone numbers](/api-reference/phone-numbers/search-phone-numbers)   | Find inventory by `place`, `areaCode`, `countryCode`, `contains` or `tollFree`. |
| [Buy phone number](/api-reference/phone-numbers/buy-phone-number)           | Buy one into the pool. Paid.                                                    |
| [Assign phone number](/api-reference/phone-numbers/assign-phone-number)     | Add a pool number to a campaign.                                                |
| [Unassign phone number](/api-reference/phone-numbers/unassign-phone-number) | Take it off one campaign.                                                       |
| [Move phone number](/api-reference/phone-numbers/move-phone-number)         | Re-home it from one campaign to another in one step.                            |
| [Release phone number](/api-reference/phone-numbers/release-phone-number)   | Give a bought number back. Irreversible. Needs `phone_numbers:release`.         |

Scoped to one agent:

| Endpoint                                                                              | Use it to                             |
| ------------------------------------------------------------------------------------- | ------------------------------------- |
| [List agent phone numbers](/api-reference/phone-numbers/list-agent-phone-numbers)     | The numbers on this agent's campaign. |
| [Search agent phone numbers](/api-reference/phone-numbers/search-agent-phone-numbers) | Search for it.                        |
| [Buy agent phone number](/api-reference/phone-numbers/buy-agent-phone-number)         | Buy and assign in one step. Paid.     |
| [Attach agent phone number](/api-reference/phone-numbers/attach-agent-phone-number)   | Attach a number you own in Twilio.    |

Scopes: `phone_numbers:read`, `phone_numbers:write`, `phone_numbers:release`.
See [Authentication](/authentication#scopes).

## Guides

* [Phone numbers and caller ID](/phone-numbers/overview)
* [Connect your own Twilio numbers](/campaigns/connect-your-twilio)
* [Glossary](/glossary#phone-numbers)