Tenant Management

Add Tenant

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

Add Tenant to MSP Account

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

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

1

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

2

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.

What Happens Next

Automatic Integration

• Tenant appears in your MSP dashboard

• GDAP permissions are automatically applied

• Access verification is performed in the background

Available Features

• Tenant switching becomes available

• Cross-tenant operations are enabled

• Unified reporting includes the new tenant

Permission Inheritance

• Delegated privileges from GDAP are applied

• Role-based access follows Partner Center configuration

• Security boundaries are automatically enforced

Troubleshooting

Tenant Not Appearing in Partner Center List

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)

Access Denied After Adding Tenant

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

Customer Not Found in Backend

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

Best Practices

Before Adding Tenants

• Verify GDAP relationship is fully established

• Confirm required permissions are approved

• Document customer requirements and scope

During Addition Process

• Select correct tenant from the list

• Verify tenant details before confirming

• Note available permissions for future reference

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

• Multi-Tenant Overview

• Managing MSP Permissions

• Switch Tenants

• Frequently Asked Questions