# Granting Microsoft Integration Permissions for Rox

This guide walks through connecting a Microsoft 365 individual integration (Outlook Calendar / Outlook Mail) to Rox when your tenant requires admin consent. The flow spans both the end user and the Microsoft admin — follow the steps in order. (For orgwide integration refer this [doc](https://docs.rox.com/development/engineering/docs/rox-enterprise-integrations/orgwide-integration-via-microsoft-graph))

***

### Step 1 — Start the connection from Rox *(end user)*

From the Rox **Integrations** page, find the Microsoft integration (for example, **Outlook Calendar**) and click **Connect**.

Review the read/write access scopes Rox is requesting and click **Connect** to proceed.

<figure><img src="/files/Ohizu3g7dNKto8qPzfM5" alt=""><figcaption></figcaption></figure>

### Step 2 — Request admin approval *(end user)*

You are redirected to Microsoft. If your tenant requires admin consent, an **Approval required** screen appears for **Rox 365 Integration** (publisher: **Rox Data Corp.**) listing the requested permissions:

* Read user calendars
* Have full access to user calendars
* View users' basic profile
* Maintain access to data you have given it access to

Enter a short justification (e.g., *"I want to sync my data to Rox"*) and click **Request approval**.

Microsoft approval required screen

<figure><img src="/files/307sBzIq9oGdFGGhsmMx" alt=""><figcaption></figcaption></figure>

### Step 3 — Confirmation that the request was sent *(end user)*

Microsoft displays a **Request sent** confirmation. Your admin is notified and you will receive an email once the request is reviewed. You can close this tab and wait for approval.

Microsoft request sent screen

<figure><img src="/files/bNAGvOisKjeQu6xduhHb" alt=""><figcaption></figcaption></figure>

### Step 4 — Open the consent request queue *(Microsoft admin)*

The admin signs in to the [Microsoft Entra admin center](https://entra.microsoft.com/) as a Global Administrator (or an Application Administrator with consent privileges) and navigates to **Entra ID → Enterprise apps → Admin consent requests**.

Pending requests for **Rox 365 Integration** appear under the **My Pending** tab. Select the request to open the details pane, verify the requester (UPN) and justification, then click **Review permissions and consent**.

Entra admin consent requests queue

<figure><img src="/files/dbregySrgDOSHmi3vuQr" alt=""><figcaption></figcaption></figure>

### Step 5 — Grant consent on behalf of the organization *(Microsoft admin)*

A Microsoft consent dialog opens listing the permissions. Verify the publisher is **Rox Data Corp.** (verified badge visible) and click **Accept**.

This grants the permissions tenant-wide — no other user in your organization will be prompted again.

Microsoft permissions requested screen

<figure><img src="/files/iZVvWaIAKSm1py4L99ql" alt=""><figcaption></figcaption></figure>

### Step 6 — Verify granted permissions *(Microsoft admin)*

To confirm the consent was applied, go to **Enterprise apps → Rox → Permissions**. Under the **Admin consent** tab, the granted Microsoft Graph permissions should be listed, for example:

| API name        | Claim value           | Permission                         | Type      |
| --------------- | --------------------- | ---------------------------------- | --------- |
| Microsoft Graph | `Calendars.Read`      | Read user calendars                | Delegated |
| Microsoft Graph | `Calendars.ReadWrite` | Have full access to user calendars | Delegated |

Entra Rox app permissions page

<figure><img src="/files/FCrsZvhwpUdQZ1jCThUF" alt=""><figcaption></figcaption></figure>

### Step 7 — Finish the connection in Rox *(end user)*

Once the admin has approved, the requesting user returns to Rox and clicks **Connect** again on the integration tile to complete the connection. No further Microsoft prompts should appear.

#### User Troubleshooting

If you are still unable to connect, please navigate to <https://myapps.microsoft.com/> and search for "Rox 365 Integration".

<figure><img src="/files/ltV8yfBv6fO9fNwgpyAv" alt=""><figcaption></figcaption></figure>

Ensure that the permissions that your admin consented to are visible here.

<figure><img src="/files/J01s7haahtal1WoJAL0P" alt=""><figcaption></figcaption></figure>


---

# 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.rox.com/development/engineering/docs/rox-enterprise-integrations/granting-microsoft-integration-permissions-for-rox.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.