The CloudRadial AutomationAI Microsoft 365 extension lets a workflow or agent work with Microsoft 365 and Microsoft Entra ID through Microsoft Graph: look up and report on users, provision and offboard accounts, manage licenses and groups, set automatic replies, lock down a compromised account, and disable a lost device. This article covers what the extension can do, the secrets it needs, which tools require approval, what it does not do, and the skills that ship with it. It is for workspace users who build automations (Admin or Owner Role).
- What the Extension Covers
- Creating the App Registration
- Providing the Credentials to Your Runner
- Reads and Approval-Gated Changes
- What the Extension Does Not Do
- Skills
- Tips for Working With Microsoft 365 Data
What the Extension Covers
The extension calls Microsoft Graph with an app-only token, so it runs unattended with no signed-in user. The catalog lists 27 tools across these areas:
| Area | What you can automate |
| Users | List and search users, look up one user's profile, account state, and licenses, create a user, update profile fields such as job title, department, office, and mobile phone, and disable an account |
| Licenses | List your subscribed license SKUs with consumed and available seat counts, read the licenses assigned to a user, and assign or remove a license |
| Groups | List and read Entra groups, list a group's members, list the groups and directory roles a user belongs to, and create a security or Microsoft 365 group |
| Mailboxes | Read a user's mailbox settings, including automatic replies, time zone, and language, and set an automatic reply (out-of-office) message |
| Account security | Reset a password so the user must choose a new one at next sign-in, revoke all active sessions and refresh tokens, and list a user's registered authentication methods |
| Sign-in and audit reporting | List recent interactive sign-ins, optionally for one user, and list directory audit events such as user, group, and license changes |
| Devices | List Entra-registered devices and disable a device so it can no longer authenticate |
Some common Microsoft 365 tasks are outside the extension. See What the Extension Does Not Do.
Install it from Extensions like any other catalog extension. See Browsing and installing extensions for the general install flow.
Creating the App Registration
The extension signs in as a Microsoft Entra ID app registration that holds Microsoft Graph application permissions with admin consent. Creating that app registration, its client secret, and its permissions is covered step by step in Creating a Microsoft 365 app registration for the Microsoft 365 extension. Complete that article first, and grant the app the Graph permissions that match the operations you plan to automate.
Providing the Credentials to Your Runner
Store three secrets in your runner's Key Vault with these exact names:
| Secret | Value |
M365-ClientID |
The Application (client) ID GUID of your Entra app registration |
M365-TenantID |
Your Entra tenant ID GUID, or a verified domain |
M365-ClientSecret |
The client secret value created under the app registration's Certificates & secrets |
The runner reads these secrets itself and the agent never asks you for them, so never paste them into a prompt or a tool input. For how to add secrets, see Accessing and updating your runner's Key Vault. If you automate a separate Microsoft 365 tenant for each client, see Managing companies and per-company credentials.
Reads and Approval-Gated Changes
Reads run without interruption. Every tool that creates or changes something is approval-gated: the run pauses and the request appears as an Action Required item in the Inbox until someone approves it. See Handling Action Required items in the Inbox.
| Tool behavior | Tools |
| Approval-gated | Create a user; update a user's profile; disable a user; reset a password; revoke sessions; assign or remove a license; create a group; set an automatic reply; disable a device |
| Read-only | List users; look up a user; read a user's licenses; read a user's group memberships; list authentication methods; list subscribed SKUs; list groups; read a group; list group members; read mailbox settings; list sign-ins; list directory audit events; list devices |
Disabling a user or a device blocks all sign-in for it, and revoking sessions signs the user out everywhere, so check the account or device before you approve.
What the Extension Does Not Do
The extension does not do the following:
- Mailbox forwarding, delegate (full access and send as) permissions, and converting a mailbox to a shared mailbox. These are Exchange Online operations. Use the Microsoft Exchange Online extension for them; see Using the Microsoft Exchange Online extension.
- Adding or removing a group member. The extension can create groups and list their members, but it does not change group membership.
- Resetting MFA. The extension can list a user's registered authentication methods, but it does not remove them.
Skills
The extension ships eight skills that guide an agent through common Microsoft 365 tasks:
| Skill | Use it to |
| Get Microsoft 365 User and Reporting | Look up a user and report on their profile, licenses, group memberships, sign-in activity, or directory audit events. Read-only. |
| Provision a Microsoft 365 User | Create an account for a new employee, or update an existing user's profile, then assign licenses. The agent looks up the user first to avoid creating a duplicate. Changes are approval-gated. |
| Offboard a Microsoft 365 User | Deprovision a departing employee: disable sign-in, revoke sessions, and remove each license the user holds. Every step is approval-gated. |
| Secure a Compromised Microsoft 365 Account | Lock down a suspected compromise: reset the password, revoke sessions, and review the user's authentication methods and recent sign-ins for anything an attacker registered. The reset and revoke steps are approval-gated. |
| Manage Microsoft 365 Licenses | Find a license SKU and its remaining seats, then assign or remove it on a user. The license change is approval-gated. |
| Manage Entra Groups | List and inspect groups and their members, or create a group. Creating a group is approval-gated. |
| Manage Microsoft 365 Mailbox Automatic Replies | Review a mailbox's settings and set an automatic reply. Setting the reply is approval-gated. |
| Manage Entra Devices | List Entra-registered devices and disable a lost, stolen, or stale device. Disabling is approval-gated. |
To give an agent these skills, see Creating custom agents and using them in workflows.
Tips for Working With Microsoft 365 Data
- Refer to users by their user principal name (UPN) where you can. The agent confirms the account before it changes anything and does not act on a guessed UPN.
- List tools return the complete result in one call, so you do not page through results. For sign-ins and audit events over a long window, ask for a narrower filter to keep results focused.
- To assign a license, the agent needs the license's SKU id. It finds it by listing your subscribed SKUs, which also shows how many seats remain.
- A password reset sets a temporary password and forces the user to choose a new one at next sign-in
- When you offboard a user and want colleagues to keep access to their mail, convert the mailbox or set forwarding with the Microsoft Exchange Online extension
- Once the secrets are in place, ask the AI Playground to look up a user to confirm the connection works
If you are still having trouble, we’re here to help! Submit a ticket here for assistance, and don’t forget to check our status page to ensure there are no outages in your area.
Comments
0 comments
Please sign in to leave a comment.