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

# Connecting CallSwitch One to Neo

> Copy the API login from your CallSwitch One portal, allow Neo's IP addresses, and save the login in Neo

You connect CallSwitch One once at the MSP level. Your reseller account's API login covers every client account under yours.

## 1. Copy the API login and allow Neo's addresses

Sign in to your CallSwitch One portal as an administrator of your reseller account and open its **API** page. It shows three values that every API call sends:

| Value | Header |
| - | - |
| **Reseller** | `X-Auth-Reseller` |
| **API user** | `X-Auth-User` |
| **API password** | `X-Auth-Password`. You can change it on the same page |

On the same page, add Neo's IP addresses from [IP whitelisting](https://docs.neoagent.io/integrations/ip-whitelisting.md) to **Allowed IP Ranges**. CallSwitch One answers API calls only from the addresses on that list, so without them Neo cannot connect.

## 2. Add the login in Neo

**1. Open Integrations**

In the Neo Dashboard, open **Integrations** and find the CallSwitch One card, under Phone & VoIP.

**2. Save the login**

Paste the reseller value, the API user and the API password, and click **Save settings**. Neo checks the login against CallSwitch One before saving, so a wrong login, or a missing entry on Allowed IP Ranges, is rejected straight away.

## 3. Check the client mapping

Open the CallSwitch One card's **Organization Mapping** tab and confirm or correct the company of each client. On a ticket, Neo acts only for the client mapped to the ticket's company. See [CallSwitch One](https://docs.neoagent.io/integrations/callswitch-one/overview.md).

## 4. Turn CallSwitch One on per agent

Open the agent, go to the Integrations section, and pick an access profile for the CallSwitch One block, or set each area yourself:

| Area | Access levels you can pick | Notes |
| - | - | - |
| **Call History and Statistics** | Disabled, Read Only | Call history with costs, call statistics, queue statistics. |
| **Call Recordings and Transcriptions** | Disabled, Read Only | Recording links and transcriptions. |
| **Outbound Calls and SMS Campaigns** | Disabled, Read Only, Read / Write | Placing calls, SMS campaigns. |
| **SIP Users, Departments and Phone Books** | Disabled, Read Only, Read / Write | Users (extensions), app invites, departments, phone books. |
| **Call Flows, Groups and Routing** | Disabled, Read Only, Read / Write | Call flows, hunt groups, queues, time diaries, call restrictions. |
| **Phone Numbers and Caller IDs** | Disabled, Read Only, Read / Write | Numbers, porting, emergency addresses, caller IDs. |
| **Voicemail, Fax and Audio** | Disabled, Read Only, Read / Write | Mailboxes and voicemail, sounds, hold music, faxes. |
| **Phones and SIP Trunks** | Disabled, Read Only, Read / Write | Provisioned phones, SIP trunks. |
| **Billing and Subscriptions** | Disabled, Read Only, Read / Write | Balances, invoices, credit notes, subscriptions, call packs. |
| **Customers and Account Settings** | Disabled, Read Only, Read / Write | Your client accounts, addresses, logins, documents, web hooks. |

See [CallSwitch One API](https://docs.neoagent.io/agents/tools/communication/callswitch-one-api.md) for the profiles and what the agent can read and change.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.