Prerequisites
- You must have Settings access in MSPortal
- An administrator from each client’s Microsoft 365 tenant must be available to approve permissions (or you must have admin credentials for their tenant)
Connecting a Company
Navigate to the M365 Companies page
Go to Settings > Integrations > Microsoft 365 > Companies.You’ll see a list of all your companies with their current connection status. A progress bar at the top shows how many companies are connected out of your total.
Click Sign in with Microsoft
Find the company you want to connect and click the Sign in with Microsoft button on its row.A popup window will open with the Microsoft sign-in page.
Authenticate and grant permissions
Sign in with an administrator account from the client’s Microsoft 365 tenant and approve the requested permissions.Once authentication succeeds, the popup will close automatically and the company will show a green Connected badge.
If your browser blocks the popup, you’ll see an error message. Allow popups for MSPortal and try again.
Using the Generate Link Option
If you sign into client Microsoft 365 tenants using a separate browser profile, a different browser, or need to send the authentication link to someone else, use the Generate Link option instead.Click Generate Link
Next to the company, click the Generate Link button. A shareable authentication URL will be generated and automatically copied to your clipboard.
Reconnecting a Company
If a company’s Microsoft 365 connection needs to be refreshed (e.g., after a token expiry or permission change), click the Reconnect button on the company’s row. This follows the same authentication flow as the initial connection.Related Documentation
- Microsoft 365 Overview - Full M365 feature guide
- M365 Licenses - License management
- M365 Domains - Domain configuration