Skip to content
English
More support Customer portal
Sign in to Gradient
  • There are no suggestions because the search field is empty.

Microsoft Integration Initial Setup

This guide walks you through setting up the Microsoft Integration from start to finish. By the end of this wizard, we will have securely connected Microsoft and your Distributor, validated GDAP access, and mapped your customers and products so reconciliation can begin.

Before You Start

To complete the setup successfully, you will need:

  • A Microsoft admin account that can grant tenant-wide consent

  • Pax8 (or in the future any distributor) admin credentials

  • GDAP relationships already established between your tenant and your customer tenants

Please refer to this article for more information on permissions requirements.

If any of that sounds fuzzy, do not worry. The wizard will call it out and we will help you fix it.

 

Step 1: Preparation

Choose Your Distributor

Select the distributor you use for Microsoft licensing.

  • Pax8 is currently supported

  • TD Synnex and Ingram Micro are coming soon

Once selected, click Next to continue.

Review the Readiness Checklist

This checklist ensures everything required for a clean Microsoft connection is in place.

You will review and confirm:

  1. Microsoft Identity Platform Admin Access

     

    Your Microsoft admin must be able to grant multi-tenant consent once for your entire organization.

  2. Pax8 Admin Access

     

    Pax8 is used to pull cost data and validate GDAP relationships.

  3. GDAP Access for Customer Tenants

    Only customers with active GDAP relationships will be available for mapping and reconciliation.

Once complete, check the confirmation box and click Next.

 

Step 2: Authentication and Verification

This step connects your Microsoft and Pax8 accounts and validates access.

 

Connect to Microsoft

Click Connect to Microsoft and sign in using your Microsoft admin account.

 

What happens here:

  • We request tenant-wide consent

  • Microsoft authorizes secure, read-only access to subscription data

When successful, you will see a confirmation message showing you are connected.

If you see errors here, it usually means the admin account does not have sufficient permissions.

 

Connect to Pax8

Click Connect to Pax8 and authenticate with your Pax8 admin credentials.

What happens here:

  • We pull Microsoft product and subscription data from Pax8

  • We verify GDAP relationships managed in Pax8

Once connected, you will see a confirmation message for Pax8 as well.

GDAP Status Review

After both connections are complete, we validate GDAP status for each customer.

You will see:

  • Active, Missing, Pending, Expired, or Error counts

  • A list of customers and their GDAP status

  • A Consent action where required

 

Only customers with:

  • Active GDAP

  • Successful consent

Will move into a Ready state.

Click Refresh after granting consent to update statuses.

You cannot continue until at least one account is Ready.

 

Step 3: Account Mapping

Now we map Microsoft customers to Pax8 accounts and PSA accounts.

How Mapping Works

  • Exact name matches are mapped automatically

  • Anything unmatched will show as Unmapped

  • You can change mappings now or later

For each Microsoft account:

  • Select the matching Pax8 account

  • Select the matching PSA account

 

Once both are selected, the status updates to Mapped.

You must map at least one account to continue.

Click Next when ready.

 

 

Step 4: Product Mapping

This step links Microsoft products to services in your PSA.

For each detected Microsoft subscription in your distributor, you will see:

  • Product name

  • Payment frequency

  • Commitment term

  • Mapping status

What You Need to Do

For each row:

  • Select the appropriate PSA Service

  • Leave products unmapped if you do not want them reconciled yet

 

Common examples:

  • Monthly vs annual commitments map to different PSA services

  • Some SKUs may intentionally stay unmapped during initial setup

 

You can return and update product mappings at any time after setup.

Once at least one product is mapped, click Next.

 

Step 5: Settings and Customization

Depending on your configuration, this step may include:

  • Billing behavior

  • Reconciliation preferences

  • Sync options

 

Review the settings carefully. Defaults are safe for most partners.

You can adjust these later.

 

Step 6: Finish and Review

This final step confirms:

  • Connections are active

  • Accounts are mapped

  • Products are mapped

  • The integration is ready to sync

 

Click Finish to complete the setup.

At this point, your Microsoft Integration is live.

 

What Happens Now?

Once setup is complete:

  • Microsoft subscription data begins syncing

  • You can access the Microsoft Integration module from the left navigation

The next article covers how to use the Microsoft Integration day to day, including how to interpret data, handle reconciliation, and spot issues quickly.

 

Coming Up Next

How to Use the Microsoft Integration

  • Navigating the module

  • Changing settings after the initial setup

  • Reviewing and reconciling Microsoft billing process

  • Common workflows and best practices