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)


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.

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

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

The admin signs in to the Microsoft Entra admin center 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

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

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

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".

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

Last updated