> For the complete documentation index, see [llms.txt](https://docs.intuneassistant.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intuneassistant.cloud/extensions/msp-support/tenant-management.md).

# Tenant Management

## Add Tenant

Step-by-step guide for adding customer tenants to your MSP home tenant

## [Add Tenant to MSP Account](#add-tenant-to-msp-account)

Learn how to add customer tenants to your MSP home tenant using GDAP relationships and Partner Center integration.

### [Prerequisites](#prerequisites)

Before adding a tenant, ensure you have:

* **Active GDAP relationship** with the customer tenant in Partner Center
* **Approved delegated admin privileges** for Intune management
* **Customer onboarded** through the regular Intune Assistant onboarding process

GDAP Requirement

An active partner-tenant GDAP relationship must be established in Partner Center before you can add the tenant to your MSP account.

### Steps to add a tenant

{% stepper %}
{% step %}

### Step 1: Access MSP Customer Settings

Navigate to your MSP account's customer management area:

* **Log into your MSP home tenant**
  * Use your primary MSP account credentials
  * Ensure you're in the correct home tenant context
* **Access customer settings**
  * Go to **Customer Settings** under your MSP account
  * This shows your current managed customer tenants

A tenant can have these badges:

|               |                                                                            |
| ------------- | -------------------------------------------------------------------------- |
| Onboarded     | Tenant is detected in Intune Assistant database already                    |
| Not onboarded | This is a complete new customer and tenant                                 |
| Linked        | Tenant is linked to your MSP account. (Should be there in the tenant list) |
| Not Linked    | Tenant is not linked to your MSP account yet.                              |

Scenarios that can happen:

|                              |                                                                                                                                                |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Onboarded not Linked         | Tenant is onboarded already, the wizard will link the tenant to your MSP account                                                               |
| Not onboarded and not linked | The customer and tenant is not in the system yet, the wizard helps you onboarding the tenant. Customer is created in the backend automatically |
| Onboarded and linked         | Not clickable, ready for use                                                                                                                   |
| {% endstep %}                |                                                                                                                                                |

{% step %}

### Step 2: Add New Tenant

* **Click "Add Tenant" button**
  * Located in the customer settings interface
  * This opens the tenant addition dialog
* **Partner Center Integration**
  * The dialog automatically fetches available partner tenants
  * Shows all tenants where you have active GDAP relationships
  * Displays tenant information from Partner Center
* **Select Customer Tenant**
  * Browse the list of available partner tenants
  * Find the customer tenant you want to add
  * Click on the desired tenant to select it
* **Confirm Addition**
  * Review the tenant details
  * Confirm the GDAP permissions available
  * Complete the addition process

Simple Process

That's it! Once you click on the tenant, it's automatically added to your MSP account with the available GDAP permissions.
{% endstep %}
{% endstepper %}

### [What Happens Next](#what-happens-next)

#### [Automatic Integration](#automatic-integration)

* **Tenant appears** in your MSP dashboard
* **GDAP permissions** are automatically applied
* **Access verification** is performed in the background

#### [Available Features](#available-features)

* **Tenant switching** becomes available
* **Cross-tenant operations** are enabled
* **Unified reporting** includes the new tenant

#### [Permission Inheritance](#permission-inheritance)

* **Delegated privileges** from GDAP are applied
* **Role-based access** follows Partner Center configuration
* **Security boundaries** are automatically enforced

### [Troubleshooting](#troubleshooting)

<details>

<summary>Tenant Not Appearing in Partner Center List</summary>

Possible causes:

* GDAP relationship not yet active
* Customer hasn't approved delegated privileges
* Partner Center sync delay

Solutions:

* Verify GDAP status in Partner Center
* Contact customer to approve pending requests
* Wait for Partner Center synchronization (up to 30 minutes)

</details>

<details>

<summary>Access Denied After Adding Tenant</summary>

Possible causes:

* Insufficient GDAP permissions
* Customer revoked delegated privileges
* Role assignments not synchronized

Solutions:

* Check delegated admin roles in Partner Center
* Request additional permissions if needed
* Contact customer to verify GDAP approval

</details>

<details>

<summary>Customer Not Found in Backend</summary>

Possible causes:

* Customer hasn't completed onboarding
* Backend synchronization pending
* Onboarding process interrupted

Solutions:

* Ask customer to complete onboarding first
* Wait for backend processing
* Retry the add tenant process

</details>

### [Best Practices](#best-practices)

#### [Before Adding Tenants](#before-adding-tenants)

* **Verify GDAP relationship** is fully established
* **Confirm required permissions** are approved
* **Document customer requirements** and scope

#### [During Addition Process](#during-addition-process)

* **Select correct tenant** from the list
* **Verify tenant details** before confirming
* **Note available permissions** for future reference

#### [After Addition](#after-addition)

* **Test access** to the new tenant
* **Verify expected functionality** is available
* **Document any limitations** based on GDAP roles

Pro Tip

Keep a record of which GDAP roles you have for each customer tenant. This helps troubleshoot permission issues and plan service delivery.

### [Related Documentation](#related-documentation)

* [Multi-Tenant Overview](https://docs.intuneassistant.cloud/extensions/msp-support/overview.md)
* [Managing MSP Permissions](https://docs.intuneassistant.cloud/extensions/msp-support/multi-tenant-permissions.md)
* [Switch Tenants](https://docs.intuneassistant.cloud/extensions/msp-support/switch-tenants.md)
* [Frequently Asked Questions](https://docs.intuneassistant.cloud/getting-started/frequently-asked-questions.md)
