# Microsoft 365 organisations

<figure><img src="https://627748108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0shDrJltbdGiCRz6ip4Z%2Fuploads%2Fa36jFDufHpVLtGSaPXn3%2FMicrosoft365-750x420.png?alt=media&#x26;token=a9568ecb-a8ee-4fc9-842b-a497c41bafb0" alt="" width="563"><figcaption></figcaption></figure>

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Get started</strong></mark></td><td>Click here to get started</td><td></td><td><a href="#introduction">#introduction</a></td></tr><tr><td><mark style="color:blue;"><strong>Permissions</strong></mark></td><td>Understanding Graph API permissions.</td><td></td><td><a href="../../integrations/calendar/microsoft-365/microsoft-365-permissions">microsoft-365-permissions</a></td></tr><tr><td><mark style="color:blue;"><strong>Limit access to mailboxes</strong></mark></td><td>Use this policy to restrict access to specific users and calendars</td><td></td><td><a href="../../integrations/calendar/microsoft-365/limit-access-to-mailboxes">limit-access-to-mailboxes</a></td></tr><tr><td><mark style="color:blue;"><strong>OAuth authentication flow</strong></mark></td><td>How your users will log in</td><td></td><td><a href="../../integrations/calendar/microsoft-365/oauth-authentication-flow">oauth-authentication-flow</a></td></tr><tr><td><mark style="color:blue;"><strong>Global admin requirements</strong></mark></td><td>Why we need your global admin to consent</td><td></td><td><a href="../../integrations/calendar/microsoft-365/global-admin-requirements">global-admin-requirements</a></td></tr><tr><td><mark style="color:blue;"><strong>Enterprise applications</strong></mark></td><td>Everything you need to know about our enterprise application</td><td></td><td><a href="../../integrations/calendar/microsoft-365/enterprise-applications">enterprise-applications</a></td></tr><tr><td><mark style="color:blue;"><strong>Add resources</strong></mark></td><td>Sync your Microsoft resources with UMA.</td><td></td><td><a href="../../integrations/calendar/microsoft-365/add-resources">add-resources</a></td></tr><tr><td><mark style="color:blue;"><strong>Room display preparation</strong></mark></td><td>Understanding Microsoft's default behaviour.</td><td></td><td><a href="../../integrations/calendar/microsoft-365/room-display-preparation">room-display-preparation</a></td></tr><tr><td><mark style="color:blue;"><strong>User sync</strong></mark></td><td>Sync your users with Microsoft 365 groups.</td><td></td><td><a href="../../integrations/calendar/microsoft-365/user-sync-legacy-search-scim">user-sync-legacy-search-scim</a></td></tr></tbody></table>

### Introduction

UMA allows you to connect to your own Microsoft 365 tenant using Graph API to sync users and resources.

{% hint style="info" %}
You will need your Microsoft Azure global admin to approve the application.
{% endhint %}

### Permissions

To understand the permissions required for the UMA Vision enterprise application click [here](https://support.meetuma.ai/uma-knowledgebase/integrations/calendar/microsoft-365/microsoft-365-permissions).

### Getting started

To get started, you should have received an email to set up your account. If you haven't, please contact your UMA representative.

Once logged in you will need to carry out the following steps:

* Configure your[ company settings](https://support.meetuma.ai/uma-knowledgebase/getting-started/settings).
* Configure your [user preferences](https://support.meetuma.ai/uma-knowledgebase/getting-started/your-preferences).

Once these initial steps have been completed you can choose to connect to your Microsoft 365 tenant now.

Navigate to the integrations page and choose Microsoft authentication to allow your employees to log in using Microsoft credentials.

<figure><img src="https://627748108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0shDrJltbdGiCRz6ip4Z%2Fuploads%2FA0y4j28I1bScct7ZdR8c%2FScreenshot%202024-05-09%20113112.png?alt=media&#x26;token=4e2217b9-9dff-48b0-868f-65df45218776" alt=""><figcaption></figcaption></figure>

Once that's done, connect your Microsoft calendar integration and consent to the [permissions ](https://support.meetuma.ai/uma-knowledgebase/integrations/calendar/microsoft-365/microsoft-365-permissions#application-permissions)requested.

{% hint style="info" %}
You will need to enter your Microsoft Entra tenant ID as part of the connection process. This can be found on the **Identity Overview** page in Entra admin center.
{% endhint %}

<figure><img src="https://627748108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0shDrJltbdGiCRz6ip4Z%2Fuploads%2FP4X5lentWQqufVmICL9T%2FScreenshot%202024-05-09%20113204.png?alt=media&#x26;token=6b23bd19-9d7a-4eec-8ec7-031427908c61" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Once connected you will need to find the **UMA Vision** enterprise application within Microsoft Entra and 'grant admin consent' to the application to fully consent to the permissions requested.
{% endhint %}

<figure><img src="https://627748108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0shDrJltbdGiCRz6ip4Z%2Fuploads%2FoiwLEnkQ0Ai86TaGNN9P%2FScreenshot%202024-05-09%20113637.png?alt=media&#x26;token=ec04003b-8a25-4396-99f9-b513e1f42fb5" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
It can take up to 24 hours for sync between Microsoft and UMA to complete. During this period you may not be able to add resources to UMA.
{% endhint %}

### Add resources

To create resources in Microsoft follow the guide [here](https://learn.microsoft.com/en-us/microsoft-365/admin/manage/room-and-equipment-mailboxes?view=o365-worldwide#set-up-room-and-equipment-mailboxes).

To import Microsoft resources into UMA follow the guide [here](https://support.meetuma.ai/uma-knowledgebase/getting-started/set-up-your-organisation/add-resources).

### Room display preparation

Microsoft's default behaviour is to not display the subject or private meetings correctly on the room display panel. To change this follow the guide [here](https://support.meetuma.ai/uma-knowledgebase/integrations/calendar/microsoft-365/room-display-preparation).

### User sync

To sync your users from Microsoft follow the guide [here](https://support.meetuma.ai/uma-knowledgebase/getting-started/users/user-sync).