> For the complete documentation index, see [llms.txt](https://support.meetuma.ai/uma-knowledgebase/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.meetuma.ai/uma-knowledgebase/getting-started/first-time-log-in/microsoft-365-organisations.md).

# Microsoft 365 organisations

Follow this guide if you are a Microsoft organisation wanting to connect your users and resources to UMA.

<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&amp;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="/uma-knowledgebase/getting-started/first-time-log-in/microsoft-365-organisations.md#introduction">Microsoft 365 organisations</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="/uma-knowledgebase/integrations/calendar/microsoft-365/microsoft-365-permissions.md">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="/uma-knowledgebase/integrations/calendar/microsoft-365/limit-access-to-mailboxes.md">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="/uma-knowledgebase/integrations/calendar/microsoft-365/oauth-authentication-flow.md">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="/uma-knowledgebase/integrations/calendar/microsoft-365/global-admin-requirements.md">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="/uma-knowledgebase/integrations/calendar/microsoft-365/enterprise-applications.md">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="/uma-knowledgebase/integrations/calendar/microsoft-365/add-resources.md">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="/uma-knowledgebase/integrations/calendar/microsoft-365/room-display-preparation.md">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="/uma-knowledgebase/integrations/calendar/microsoft-365/user-sync-legacy-search-scim.md">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](/uma-knowledgebase/integrations/calendar/microsoft-365/microsoft-365-permissions.md).

### 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](/uma-knowledgebase/getting-started/settings.md).
* Configure your [user preferences](/uma-knowledgebase/getting-started/your-preferences.md).

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&amp;token=4e2217b9-9dff-48b0-868f-65df45218776" alt=""><figcaption></figcaption></figure>

Once that's done, connect your Microsoft calendar integration and consent to the [permissions ](/uma-knowledgebase/integrations/calendar/microsoft-365/microsoft-365-permissions.md#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&amp;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&amp;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](/uma-knowledgebase/getting-started/set-up-your-organisation/add-resources.md).

### 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](/uma-knowledgebase/integrations/calendar/microsoft-365/room-display-preparation.md).

### User sync

To sync your users from Microsoft follow the guide [here](/uma-knowledgebase/getting-started/users/user-sync.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.meetuma.ai/uma-knowledgebase/getting-started/first-time-log-in/microsoft-365-organisations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.