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

# Pax8

> Connect Pax8 so agents can read subscriptions and prices, add or remove licence seats, and order a product a client does not hold yet

Neo connects to the [Pax8 Partner API](https://devx.pax8.com/). With it connected, an agent can:

* Read companies, contacts, subscriptions, orders, invoices and usage
* Look up products, the price you pay per billing term, commitment terms and the details an order needs
* Order a product a client does not hold yet, after a technician approves it
* Add or remove seats on an existing subscription with [Change License Seats](/agents/tools/m365/change-license-seats)

## Connect Pax8

<Steps>
  <Step title="Create an API credential">
    In Pax8, open **Integrations → Credentials** and create an API credential. View it to copy the **Client ID** and **Client Secret**.
  </Step>

  <Step title="Save it in Neo">
    Open [**Integrations**](https://dashboard.neoagent.io/integrations?open=pax8), select **Pax8**, enter the Client ID and Client Secret, and click **Save**.
  </Step>

  <Step title="Map each company">
    On the [Companies](https://dashboard.neoagent.io/end-companies) page, open a company and add its Pax8 company ID under **Marketplace Company IDs**. Find the ID in the Pax8 portal on the company's page. Agents use this ID for orders and cancellations, and each approval request names the Pax8 company.
  </Step>
</Steps>

## What agents can do

Agents call Pax8 through the [Vendor API](/agents/tools/vendor-api) tool, which is added when you give the agent Pax8 permissions in its settings. Each permission group has its own access level:

| Permission group | What it covers |
| - | - |
| **Companies** | Pax8 companies, creating or updating one |
| **Contacts** | A company's contacts and their roles |
| **Products & Pricing** | Products, your cost per billing term, commitment terms and provisioning details (read-only) |
| **Subscriptions** | Subscriptions, seat counts and history, cancellation |
| **Orders** | Order history and new orders |
| **Invoices & Usage** | Invoices, invoice lines and usage (read-only) |

The access profiles are **Read Only**, **Helpdesk** (every change asks a technician first) and **IT Admin** (no approval, except the two changes below). You can set approval per permission group.

<Warning>
  A new order and a subscription cancellation always ask a technician for approval, in every profile. Pax8 bills you for an order, and Microsoft does not let you reduce or cancel an annual commitment after its first days.
</Warning>

## Buying a product a client does not hold

1. The agent finds the product, your price for the billing term, the commitment term and the provisioning details Pax8 needs.
2. It asks a technician to approve the order. The request names the product, the quantity, the billing and commitment terms, the price and what the commitment allows, such as "seats cannot be reduced until the term ends".
3. After approval, it places the order with exactly those values.
4. For a Microsoft product, once the new subscription is active and the licence shows in the client's Microsoft 365 tenant, the agent assigns it if it has the M365 Licensing permission; otherwise it uses your licensing tool, such as CIPP, or hands the step to a technician.

When a company has order approval turned on in Pax8, the order waits there until someone approves it in Pax8.

## Seat changes

To add or remove seats on a subscription the client already holds, the agent uses [Change License Seats](/agents/tools/m365/change-license-seats). It changes one subscription at a time and reads the new count back. The Vendor API tool refuses every subscription update, so a seat change made at the same time cannot overwrite it. Change a billing term in the Pax8 portal.


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