Microsoft Teams

This article explains how to connect your Microsoft Teams account.

Connecting

You can connect your Microsoft account from your profile page in Claras. Click your profile photo and then My Profile.

Under integrations, you'll see an option for Microsoft Teams. Click the Connect button to go through the connection flow.

There are three possible situations you may encounter during the connection flow:

Permission already granted

If your admin has already granted permission, it will connect automatically and redirect you back to Claras after a few seconds. If that's the case, the feature will now work and no further action is required from your end.

You can grant permission

If you're presented with a screen like this, it means you're an admin of your Microsoft account and can grant access to the new permissions.

We recommend checking the "Consent on behalf of your organisation" option if you have other team members in Claras who will use the integration. They'll still need to connect, but it will flow through automatically as mentioned above.

You need your IT admin to approve

If you're presented with a screen like this, it means you don't have admin access to your Microsoft account. You will need to ask your IT admin to grant access to the permissions. You can send them the link to this article which will help with the process.

Once your admin has granted consent for your organisation, you'll need to go through the connection process again (starting from your profile page in Claras). It should flow through automatically and redirect you back to Claras.

As an admin, you may need to grant or regrant admin consent for the Claras integration. This can be done via Entra.

Navigate to Enterprise apps → All applications → Claras → Permissions and click Grant admin consent. Refresh to ensure the permissions (or new permissions) appear, then let your team member know they can go through the connection process again.

Reconnecting

As we release new features, they may require additional permissions to work. You'll see a message in Claras like this:

Click the Reconnect Microsoft Account button to navigate to your profile. Then click the Reconnect button.

You will go through the same connection flow as mentioned above.

Required permissions

Here are the current permissions (also known as "scopes" or "claims") we require for the integration to work, along with an explanation of each.

Permission	Claim Value	Reason
Sign in and read user profile	`User.Read`	Access basic information such as name, email, and id for api calls.
Maintain access to data you have given it access to	`offline_access`	Background processing using refresh tokens.
Read user calendars	`Calendars.Read`	Show scheduled meetings.
Read user's online meetings	`OnlineMeetings.Read`	Show scheduled meetings.
Read all recordings of online meetings	`OnlineMeetingRecording.Read.All`	Extract audio to create file notes from recordings.
Read all transcripts of online meetings	`OnlineMeetingTranscript.Read.All`	Create file notes from transcripts if there's no recording.
Read user chat messages	`Chat.Read`	Show "Meet now" instant meetings.
Read user's online meeting artifacts	`OnlineMeetingArtifact.Read.All`	Show who attended "Meet now" instant meetings.

Last updated 22nd October 2025 by Connor