> ## 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 Manage Protect to Neo

> Get a Manage Protect Partner API token, save it in Neo, check the customer mapping, and turn on seat changes and billing reads

Manage Protect's Partner API takes one token per partner. Manage Protect issues it; there is no key to make yourself.

## 1. Get a token from Manage Protect

Ask your Manage Protect contact for a Partner API token.

* A **read only** token is the default. It reads seats, subscriptions, invoices, the forecast, changes and the catalogue.
* A **read / write** token also changes seats, buys licences, cancels subscriptions and creates customers. Ask for it if Neo should do those.

## 2. Add the token in Neo

**1. Open Integrations**

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

**2. Save the token**

Paste the token as Manage Protect sent it and click **Save settings**. Neo reads your customer list with it before saving, so a mistyped or revoked token is rejected straight away.

> [!WARNING]
>
> If Manage Protect revokes the token, Neo loses access until you save a new one here.

## 3. Check the customer mapping

Neo matches each Manage Protect customer to a PSA company by the Microsoft tenant of the domain Manage Protect holds for it, then by name. Your own Partner account, where internal-use licences sit, is in the list too. Open the Manage Protect card's **Organization Mapping** tab to correct a match or confirm a suggested one. To set one by hand, click **Map** or **Re-map** on the customer's row; your mapping wins over a match and is kept across syncs. The mapping is all a seat change needs.

## 4. Turn on seat changes

Add **Change License Seats** and **List License Subscriptions** to the agents that handle licence requests, onboarding and offboarding. 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 a ticket asks for a licence, use a free one if there is one; otherwise add a seat on Manage Protect, or buy the product if the customer does not have it."

Seat changes need a read / write token.

## 5. Turn the Manage Protect API on per agent

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

| Area | Access levels you can pick | Notes |
| - | - | - |
| **Customers** | Disabled, Read Only, Read / Write | Your customers, new customers, and deactivating or reactivating one. A customer with a Microsoft tenant is permanent. |
| **Subscriptions** | Disabled, Read Only, Read / Write | Seat counts, what Microsoft did with each change, renewals, suspensions, cancellations, add-ons and upgrades. A cancellation or an upgrade cannot be undone. |
| **Orders** | Disabled, Read Only, Read / Write | The catalogue with your prices, and purchases. A purchase is charged to you. |
| **Microsoft Tenants** | Disabled, Read Only, Read / Write | New tenants, the Microsoft Customer Agreement and GDAP invitations. A new tenant is permanent. |
| **Billing** | Disabled, Read Only | Every subscription with prices, invoices and their lines, the forecast, and changes between periods. |

| 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, customers and purchases | Subscription changes, tenants and GDAP invitations |
| **Full Automation** | Every read and every write | Nothing |

## 6. Reconcile the monthly bill

A chat agent or a scheduled agent can read the month's invoice and compare each line with the agreement additions in your PSA. Ask your Neo Support Agent to set it up: for example, "Each month, read the Manage Protect invoice, leave out pro-rata lines, match each line to the customer's ConnectWise agreement addition by product code, and show me every quantity that differs before changing anything."

Billing reads cover every customer, so they run from a chat or a scheduled agent, as does the catalogue with your wholesale prices. An agent working on one customer's ticket reads only that customer's seats and subscriptions.

See [Manage Protect API](https://docs.neoagent.io/agents/tools/marketplace/manage-protect-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.