Microsoft Office 365 connector icon

Microsoft Office 365 Connector

Build in-app integrations that let customers sync mail, calendars, files and users between your SaaS product and Microsoft Office 365. Use Cyclr to orchestrate workflows, embed prebuilt actions and expose governed automation tools to your customers.

01

Faster time to market

Deliver integrations without building custom connectors from scratch

02

Prebuilt Graph actions

Use ready-made actions for mail, calendars and files

03

Governed MCP tools

Expose controlled, auditable automations to customers

04

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

Overview

Cyclr’s Microsoft Office 365 connector uses Microsoft Graph to access mail, calendars, OneDrive and directory resources. SaaS teams can build customer-facing integrations, orchestrate cross-app workflows and publish white-label integrations in an embedded marketplace. Expose supported connector methods as governed MCP tools so customers run safe, auditable automations inside your product.

PRODUCT USE CASES

Top use cases

Create high-value automations like calendar sync, email notifications, user provisioning and file archival. Publish these integrations in your embedded marketplace so customers can enable workflows without leaving your app.

Two-way calendar sync

Keep customer and product calendars in sync so meetings, reminders and bookings stay current across systems.

Automated email notifications

Trigger outbound emails or notifications from your app when sales events happen using Office 365 mail actions.

File archival and transfer

Automatically copy or archive files from your app to OneDrive or SharePoint for central storage and compliance.

ORCHESTRATION

How Microsoft Office 365 works with Cyclr

Cyclr sits between your SaaS product and Microsoft Office 365 to handle authentication, govern access and orchestrate every API call per customer, at scale.

  1. 1

    Your SaaS product

    Your app requests an action for a specific customer.

  2. 2

    Cyclr orchestration

    Cyclr authenticates, applies policies and routes the request.

  3. 3

    Microsoft Office 365

    Microsoft Office 365 processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore Microsoft Office 365 methods you can orchestrate through Cyclr.

Emails12

List New Emails By User

Action

List emails from the specified user's inbox that have been created since the last run.

List Message Attachments

Action

List the attachments of the specified message.

List Emails By Folder

Action

List a user's emails from the specified folder.

List Updated Emails By User

Action

List emails from the specified user's inbox that have been updated since the last run.

Get Message Attachment (Raw)

Action

Retrieve the raw content of the specified attachment.

List Updated Emails By Folder

Action

List a user's emails from the specified folder that have been updated since the last run.

Create Draft Message

Action

Create a draft of a new message.

List New Emails By Folder

Action

List a user's emails from the specified folder that have been created since the last run.

Get Message By ID

Action

Retrieve the specified message.

Send Email

Action

Send the message specified in the request body.

List Mail Folders

Action

List a user's mail folders.

List Emails By User

Action

List emails from the specified user's inbox.

Events14

Forward Calendar Event Request

Action

This action allows the organizer or attendee of a meeting event to forward the meeting request to a new recipient.

Forward Event Request

Action

This action allows the organizer or attendee of a meeting event to forward the meeting request to a new recipient.

Create Calendar Event

Action

Create a calendar event.

Find Meeting Times

Action

List possible available meeting times based on users calendar.

Forward Group Event Request

Action

This action allows the organizer or attendee of a meeting event to forward the meeting request to a new recipient.

List New Calendar Events

Action

List all the events of a user's calendar since the last run.

Get Calendar Event

Action

Get a calendar event.

Delete Calendar Event

Action

Delete a calender event.

Get Next Event Instance

Action

Gets details of when a recurring event will next take place. Recurring events have a Type of "seriesMaster".

List User's Events

Action

List a user's events.

Get Group Event

Action

Get a group event.

List Calendar Events

Action

List all the events of a users calendar.

Update Calendar Event

Action

Update a calendar event.

List Updated Calendar Events

Action

List all the events of a user's calendar created or updated since the last run.

Service Principals2

List Service Principals

Action

Retrieve a list of service principals.

List App Roles Assigned to Service Principal

Action

Lists app role assigned to a service principal.

Webhook2

List Subscriptions

Action

Retrieve the properties and relationships of webhook subscriptions, based on the app ID, the user, and the user's role with a tenant.

Webhook

Webhook

General purpose webhook receiver for Microsoft Office 365. Please see the documentation (https://docs.microsoft.com/en-us/graph/api/resources/webhooks?view=graph-rest-1.0) for details on the Resource types available.

Users13

List Deleted Users

Action

List all deleted users.

Get User Mailbox Settings

Action

Get the mailbox settings of a user.

Get User By Email

Action

Get a user from the email address provided.

List Users

Action

List all users.

Get User Manager

Action

Get the manager of a user.

Upsert User Licenses

Action

Create or remove a users licenses.

List User Licenses

Action

List all licenses of a user.

List New Users

Action

List all users created since the last successful run.

Delete User

Action

Delete a user.

List User Schedules

Action

List all schedules for a user.

Get Multiple Users

Action

Return the specified users.

Get User

Action

Get a user.

Create User

Action

Create a user.

Calendars8

Create Calendar

Action

Create a calendar.

Update Calendar

Action

Update a calendar.

List Calendars

Action

List all the calendars of a user.

Delete Calendar

Action

Delete a calendar.

Get Calendar

Action

Get a calendar.

List Calendar Events

Action

List all the calendar events for a user between two dates.

Create Calendar Event

Action

Create an event in the specified calendar.

Get User Calendar Availability

Action

Get the free/busy availability information for a user.

Entra Audit Logs2

Batch List Sign-in With Photo

Action

Creates a batched call to return user sign-in details along with the users photograph.

List Sign-Ins

Action

List all the Microsoft Entra user sign-ins for your tenant.

Calendar Groups5

Get Calendar Group

Action

Get a calendar group.

Delete Calendar Group

Action

Delete a calendar group.

Update Calendar Group

Action

Update a calendar group.

Create Calendar Group

Action

Create a calendar group.

List Calendar Groups

Action

List all the calendar groups of a user.

Groups9

Delete User From Group

Action

Delete a user from a group.

Add User To Group

Action

Add a user to a group.

List Groups

Action

List all the groups in an organization, including but not limited to Microsoft 365 groups.

Get Group by Name

Action

Get filtered group from an organization by name, including but not limited to Microsoft 365 groups.

List Group Members

Action

List all members of the specified group.

List Deleted Groups

Action

List all deleted groups in an organization, including but not limited to Microsoft 365 groups.

Get Group

Action

Get a group by ID.

Upsert Group

Action

Create a new group if it doesn't exist, or update the properties of an existing group.

Get Group's Drive

Action

Get a group's drive ID.

Usage Reports2

List Active User Details

Action

List details about Microsoft 365 active users.

Get Active User Details Report

Action

Download Microsoft 365 active users report in CSV format.

Sites10

Get Root Site

Action

Access the root SharePoint site within a tenant.

List Site Drives

Action

List all drives for the specified site.

List Sites

Action

Lists all sites.

List Site Libraries

Action

To list the document libraries for a site, your app requests the drives relationship on the Site.

List Subsites

Action

List all subsites defined for a site.

Get List Item

Action

Get an item from a list.

List Site Lists

Action

List all lists for a site.

List List Items

Action

List all list items in a list.

Get Site List

Action

Get a list for a site.

List List Item Document Set Versions

Action

List all document set versions of a list item.

Profile Photo2

Get Photo

Action

Get the photo.

Get Photo Metadata

Action

Get the metadata of the photo.

List Items (Site ID|List ID|Item ID)2

Update List Item Column Values

Action

Update the column values of a list item.

Get List Item

Action

Get an item from a list.

Subscriptions9

Create Subscription

Action

Create a new subscription.

Get Subscription

Action

Get a single subscription by ID.

List Subscriptions

Action

List all subscriptions.

Delete Subscription

Action

Delete a single subscription by ID.

Update Subscription

Action

Renew a subscription by extending its expiry time.

Get Subscribed SKU

Action

Get a single subscribed SKU by ID.

List Subscribed SKUs

Action

List all subscribed SKUs.

List Company Subscriptions

Action

List all company subscriptions.

Get Company Subscription

Action

Get a single company subscription by ID.

Contracts2

List Contracts

Action

List all contracts.

Get Contract

Action

Get the specified contract.

SharePoint2

List SharePoint Drives

Action

Lists all SharePoint drives the authenticated user has access to.

Create List

Action

Create a list under a given site ID. Includes document library.

OneDrive44

Delete Group Drive Item

Action

Delete an item from a Group.

Get Drive Item Metadata

Action

Retrieve the specified items metadata.

Move User Drive Item

Action

Move an item within a users Drive.

List Drives

Action

Lists all Drives the authenticated user has access to.

Delete Drive Item

Action

Delete an item from a Drive. Leaves through the True Exit if a deletion is successful, else through the False Exit if the item to delete is not found.

Get Drive Item Metadata by Path

Action

Retrieve the specified items metadata.

List Updated Drive Items (BETA)

Action

Track changes in Drive Items and their children over time.

Create Group Drive Folder

Action

Create a new Drive folder in a group.

List Site Drive Item Children

Action

Lists the children of a drive item in a Site.

Get Site Drive Item

Action

Retrieve the specified item, including file content.

Create Drive Folder

Action

Create a new Drive folder.

Get Drive Item

Action

Retrieve the specified item, including file content.

Create Site Drive Folder

Action

Create a new Drive folder in a site.

List Group Drive Item Permissions

Action

Lists the Permissions of a drive item in a Group.

Delete User Drive Item

Action

Delete an item from a User drive.

Upload Drive Item

Action

Upload an item to a Drive.

Get Drive Delta

Action

Get the delta for the specified drive.

List Site Drive Items

Action

Lists all files in a Sites Drive.

Get User Drive Item

Action

Retrieve the specified item, including file content.

List User Drive Items

Action

Lists all files in the root of a users Drive.

List Root Drive Items

Action

Lists all items in the root of a Drive.

List Drive Items

Action

Lists all items in the root of a Drive.

Get Group Drive Item Metadata

Action

Retrieve the specified item.

List Group Drive Items

Action

Lists all items in the root of a Groups Drive.

Get Users Drive Delta

Action

Get the delta for the specified users drive.

Download Drive Item by URL

Action

Retrieve the specified item file content by URL.

Get User's OneDrive

Action

Get a user's OneDrive.

List User Drive Item Permissions

Action

List the effective sharing permissions on a User Drive Item.

List Drive Item Permissions

Action

Lists the permissions of a drive item.

Get User Drive Item Metadata

Action

Retrieve the specified items metadata.

List Drive Item Children

Action

Lists the children of a drive item.

Get Converted Drive Item URL

Action

Retrieve a link for a drive item converted into the specified format.

Get Group Drive Item

Action

Retrieve the specified item, including file content.

List User Drive Item Children

Action

Lists the children of a User drive item.

List Site Drive Item Permissions

Action

Lists the Permissions of a drive item in a Site.

Move Group Drive Item

Action

Move a drive item within a group Drive.

Delete Site Drive Item

Action

Delete an item from a Site Drive.

Get Drive Item by Path

Action

Retrieve the drive item from the specified path (including content)

Create User Drive Folder

Action

Create a new Drive folder for the specified user ID.

Get Site Drive Item Metadata

Action

Retrieve the specified item metadata.

Copy User File

Action

Create a copy of an item within a users Drive.

List Group Drive Item Children

Action

Lists the children of a drive item in a Group.

Move Drive Item

Action

Move an item within a Drive.

Move Site Drive Item

Action

Move an item within a Site Drive.

Identity and Access9

Delete FIDO2 Security Key Authentication Method

Action

Deletes a user's FIDO2 Security Key Authentication Method object.

Reset Password

Action

Reset the password of a user.

Delete Phone Authentication Method

Action

Delete the phone authentication method of a user.

Delete Microsoft Authenticator Authentication Method

Action

Delete the Microsoft Authenticator authentication method of a user.

Delete Windows Hello For Business Authentication Method

Action

Delete your own or another user's Windows Hello For Business authentication method.

Delete Email Authentication Method

Action

Delete the email authentication method of a user.

Delete Software OATH Token Authentication Method

Action

Delete a user's Software OATH token authentication method object.

List Authentication Methods

Action

List all authentication methods of a user.

Delete Temporary Access Pass Authentication Method

Action

Delete the temporary access pass authentication method of a user.

OneDrive - Excel11

List Sheets

Action

Gets all sheets within a specific workbook.

Delete Table

Action

Delete the selected table.

Get Worksheet Range

Action

Gets the range object specified by the address or name.

List Rows

Action

Get a list of tablerow objects

Append Table Rows

Action

Adds new rows to the end of the table.

Create Table

Action

Adds a new table to the workbook.

Get Cell

Action

Get a specific cell within a worksheet.

Delete Worksheet

Action

Deletes a worksheet from the workbook.

Set Cell

Action

Set the value of the specified cell.

Add Worksheet

Action

Adds a new worksheet to the workbook.

List Tables

Action

Gets all tables within a specific workbook.

Planner6

List Bucket Tasks

Action

Lists all planner tasks associated with a bucket.

Create Plan

Action

Create a new Plan.

List Plan Tasks

Action

Lists all planner tasks associated with a plan.

List Plan Buckets

Action

Lists all buckets associated with a plan.

List Group Plans

Action

Lists all the plans owned by a group.

Get Plan

Action

Get information for a Plan

TECHNICAL DETAILS

Microsoft Office 365 integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing Microsoft Office 365 integrations in Cyclr.

API and authentication

API host
https://graph.microsoft.com
Authentication
OAuth 2.0 via Microsoft identity platform (Azure AD)
Credentials

Tenant ID, Client ID, Client secret, OAuth redirect URL, requested Microsoft Graph scopes

Method categories

Users, Mail, Calendars, Events, Files, Groups, Contacts, Messages, Permissions

View vendor API documentation →

Pagination and rate limits

Pagination

Microsoft Graph returns @odata.nextLink or skipToken for paged results; follow nextLink or use delta queries for incremental sync.

Rate limits

Microsoft Graph enforces service-specific throttling; 429 responses and Retry-After header indicate when to back off.

IMPLEMENTATION

Authentication at a glance

OAuth 2.0 with delegated and client credentials flows through Azure AD app registration; supports scope-based Microsoft Graph consent and token exchange.

Authentication method
OAuth 2.0 via Microsoft identity platform (Azure AD)
Credential required

Tenant ID, Client ID, Client secret, OAuth redirect URL, requested Microsoft Graph scopes

Before you begin:

Requires Azure AD app registration and possibly admin consent for tenant-wide scopes.

View setup guide

COMMON QUESTIONS

Frequently asked questions

The connector uses Microsoft Graph to access mail, calendars, files, users, groups and directory resources.

Authenticate via Azure AD using OAuth 2.0. Cyclr supports delegated user flows and client credentials for app-only access.

Yes. Cyclr lets you surface selected connector methods as governed MCP tools with role-based access, usage limits and telemetry.

Yes. Microsoft Graph subscriptions provide change notifications; your Cyclr workflows can receive and process those webhooks.