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

<figure><img src="/files/KDlkBVrdK7jrbxyXFVRG" alt=""><figcaption></figcaption></figure>
{% 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](/extensions/msp-support/overview.md)
* [Managing MSP Permissions](/extensions/msp-support/multi-tenant-permissions.md)
* [Switch Tenants](/extensions/msp-support/switch-tenants.md)
* [Frequently Asked Questions](/getting-started/frequently-asked-questions.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.intuneassistant.cloud/extensions/msp-support/tenant-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.