> ## 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.

# Manage Protect API

> Read Manage Protect seats, subscriptions, invoices, the forecast and period changes, and manage purchases, renewals, cancellations, customers, tenants and GDAP invitations

The common uses are the monthly check of the Manage Protect bill against your PSA agreements, a customer's seat count and renewal date, and a licence request on a ticket (is a seat free, does the customer hold the product, buy it if not). A Microsoft seat change itself goes through [Change License Seats](https://docs.neoagent.io/agents/tools/m365/change-license-seats.md).

> [!NOTE]
>
> Automatically enabled when you configure Manage Protect permissions in your agent workflow.

## What It Does

* Find the customer's Manage Protect ID from the company mapping, or in the customer list
* Read a customer's seats per product and commitment, with renewal date, auto-renew and where each figure came from, and read one subscription live
* Read every subscription with your price and the list price, invoices and their lines, the open period's forecast, and the changes between two invoice periods
* Check what Microsoft did with each seat, renewal, suspend, resume, add-on and upgrade change
* Buy a product after a preview, and follow the order until Microsoft provisions it
* Set what a subscription renews into, suspend, resume, cancel after a preview, add an add-on and upgrade it
* Create customers and Microsoft tenants, check the Microsoft Customer Agreement, and send the GDAP invitation

## Permission Groups

| Group | Covers |
| - | - |
| Customers | Your customers, new customers, and deactivating or reactivating one |
| Subscriptions | Seat counts and subscriptions, what Microsoft did with each change, renewals, suspensions, cancellations, add-ons and upgrades |
| Orders | The catalogue with your prices, purchases and their progress |
| Microsoft Tenants | New tenants, the Microsoft Customer Agreement and GDAP invitations |
| Billing | Every subscription with prices, invoices and their lines, the forecast, and changes between periods (read-only) |

## Access Profiles

| Profile | 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 |

## Safety Controls

| Control | Behavior |
| - | - |
| **Microsoft seat counts** | Only [Change License Seats](https://docs.neoagent.io/agents/tools/m365/change-license-seats.md) changes a seat count. This tool refuses the quantity change, so a change always goes through the subscription lock |
| **Purchases and changes to a customer** | A purchase or a change goes only to a customer mapped to one of your companies. On a run with no ticket company, a write to a customer no company maps runs only when a technician approves that exact call on a card that says the customer is unconfirmed; on a ticket, see the next row |
| **One customer per ticket** | On a ticket, every call about a customer must name the customer mapped to the ticket's company. Calls across every customer (the customer list, every subscription, invoices, the forecast and the period changes), the catalogue with your wholesale prices, and creating a customer run only from a chat or a scheduled agent |
| **Sent once** | A seat, renewal, suspend, resume or cancel change is sent once, as Manage Protect asks. A purchase and a new customer or tenant carry an idempotency key, so a resend after a timeout never buys or creates twice |
| **Admin sign-in** | Neo never collects a new tenant's Global Administrator password, which Manage Protect shows once: an agent that reads ticket text could be steered to pass it on. Collect it from Manage Protect |
| **Calls** | Neo sends only the operations the Manage Protect Partner API documents. Every other call is refused |
| **Token** | Neo adds your token to each call; the agent never sees it |


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