> ## 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 ArrowSphere to Neo

> Generate an ArrowSphere API key, save it in Neo, check the customer mapping, and turn on seat changes

You connect your ArrowSphere account once with an API key. Neo then reaches every customer the key's user can see.

## 1. Generate an API key

**1. Open API keys**

Sign in to [ArrowSphere](https://xsp.arrow.com) and open **API > API keys** in the top bar.

**2. Generate the key**

Select **Generate a new key** and follow the wizard. Generate it as a user whose roles reach your customers and their licences: the key can do what that user can do.

**3. Copy the key**

Copy the key. You can see your keys again on the same page.

## 2. Add the key in Neo

**1. Open Integrations**

In the Neo Dashboard, open **Integrations** and find the ArrowSphere card, under Cloud Marketplace.

**2. Save the key**

Paste the API key and click **Save settings**. Neo reads your partner account with it before saving, so a wrong or revoked key is rejected straight away.

> [!WARNING]
>
> If you revoke the key in ArrowSphere, Neo loses access until you save a new one here.

## 3. Check the customer mapping

Neo matches each ArrowSphere customer to a PSA company by its Microsoft tenant ID, then by name. Open the ArrowSphere card's **Organization Mapping** tab to correct a match or confirm a suggested one. To set one by hand, type the customer reference (such as `XSP12345`) as the company's **Marketplace Company ID** on the **Companies** page, with ArrowSphere as the marketplace. Seat changes also need the company's Microsoft tenant ID, so Neo can confirm the new seat in Microsoft 365.

## 4. Turn on seat changes

Add **Change License Seats** and **List License Subscriptions** to your onboarding and offboarding agents. In Change License Seats, turn on **Require technician approval** if a technician should confirm each seat change. Ask your Neo Support Agent to set this up: for example, "When someone joins, ask the technician which licence to add and buy the seat; when someone leaves, schedule the seat reduction for the renewal date."

## 5. Turn the ArrowSphere API on per agent

For everything beyond seat counts, open the agent, go to its **Tools & Settings** tab, click **Cloud Marketplace**, and expand the **ArrowSphere** block. Pick one of its **Presets**, or set each area yourself:

| Area | Access levels you can pick | Notes |
| - | - | - |
| **Customers** | Disabled, Read Only, Read / Write | Customers, their contacts, agreements and provisioning. Deleting a customer always asks a technician. |
| **GDAP and Customer Access** | Disabled, Read Only, Read / Write | GDAP relationships and GDAP links. |
| **Licenses** | Disabled, Read Only, Read / Write | Licences, renewals, scheduled term changes, auto-renew, suspend and reactivate. Cancelling a licence always asks a technician. |
| **Pricing and Rates** | Disabled, Read Only, Read / Write | Your resale rates, special bids and billing comments. |
| **Orders** | Disabled, Read Only, Read / Write | Orders for new products and add-ons. An order is charged to you. |
| **Quotes** | Disabled, Read Only, Read / Write | Quotes with Arrow and your customers. |
| **Catalog** | Disabled, Read Only | Products, offers and prices. |
| **Statements and Consumption** | Disabled, Read Only, Read / Write | Billing statements, exports, consumption and usage reports. |
| **Partner Account** | Disabled, Read Only, Read / Write | Programs, organization units, custom fields and campaigns. |
| **Partner Users** | Disabled, Read Only, Read / Write | Who signs in to your ArrowSphere account. Removing MFA always asks a technician. |
| **Support Issues** | Disabled, Read Only, Read / Write | Your cases with Arrow support. |

| Preset | What runs on its own | What asks a technician |
| - | - | - |
| **Read Only** | Every read | No write is allowed |
| **Helpdesk** | Every read | Every write |
| **IT Admin** | Every read, and customers, licences, orders, quotes and the rest | GDAP links and partner user changes |
| **Full Automation** | Every read and every write | Deleting a customer, cancelling a licence, removing MFA, anonymizing users, and bulk changes from an uploaded file |

See [ArrowSphere API](/agents/tools/marketplace/arrowsphere-api.md) for what the agent can read and change.


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