Outlook
Microsoft email service for mailboxes, messages, threads, folders, contacts, attachments, and delivery activity.
Covers Outlook mail and contacts, including drafts, replies, labels, attachments, new messages, and contact changes.
Related integrations
Example Use Cases
These are the Outlook actions Snow can use when building apps with you. Connecting an account does not make Snow run these on its own.
Accepts or tentatively accepts a calendar meeting invite on behalf of a user. Use this action when a user has received a meeting invitation and wants to indicate their attendance status (either confirmed or tentative). The organizer will receive a notification of the acceptance unless send_response is set to false.
Tool to add an attachment to an email message. Use when you have a message ID and need to attach a small (<3 MB) file or reference.
Batch-move up to 20 Outlook messages to a destination folder in a single Microsoft Graph $batch call. Use when moving multiple messages to avoid per-message move API calls.
Batch-update up to 20 Outlook messages per call using Microsoft Graph JSON batching. Use when marking multiple messages read/unread or updating other properties to avoid per-message PATCH calls.
Tool to copy an email message to another folder within the user's mailbox. Use when duplicating messages to multiple folders for organization.
Creates a new Outlook calendar event, ensuring `start_datetime` is chronologically before `end_datetime`.
Creates a new contact in a Microsoft Outlook user's contacts folder.
Creates a new Outlook email draft with subject, body, recipients, and an optional attachment. This action creates a standalone draft for new conversations. To create a draft reply to an existing conversation/message, use the OUTLOOK_CREATE_DRAFT_REPLY action instead.
Create email rule filter with conditions and actions
Tool to create a new task in Microsoft To Do within a specified task list. Use when adding tasks with title, due dates, reminders, importance levels, descriptions, categories, and linked resources.
Tool to decline an invitation to a calendar event. Use when the user wants to decline a meeting or event invitation. The API returns 202 Accepted with no content on success.
Tool to delete a calendar other than the default calendar from a user's mailbox. Use when removing calendars that are no longer needed.
Delete a mail folder from the user's mailbox. Use when you need to remove an existing mail folder.
Downloads a specific file attachment from an email message in a Microsoft Outlook mailbox; the attachment must contain 'contentBytes' (binary data) and not be a link or embedded item. The returned data.file.s3url is temporary — download the file immediately after calling this tool; call again to get a fresh URL if needed. High-volume parallel calls may trigger HTTP 429 responses; honor the Retry-After header and use exponential backoff.
Suggests meeting times based on organizer and attendee availability, time constraints, and duration requirements. Use when you need to find optimal meeting slots across multiple participants' schedules.
Tool to forward a message. Use when you need to send an existing email to new recipients.
Tool to forward a calendar event from a specific user's calendar to new recipients. Use when you need to share an event from a particular calendar with additional people.
Retrieves the full details of a specific calendar event by its ID from a user's Outlook calendar, provided the event exists.
Get events ACTIVE during a time window (includes multi-day events). Use for "what's on my calendar today/this week" or availability checks. Returns events overlapping the time range. For keyword search or filters by category, use OUTLOOK_LIST_EVENTS instead.
Retrieves a specific Outlook contact by its `contact_id` from the contacts of a specified `user_id` (defaults to 'me' for the authenticated user).
Retrieve incremental changes (delta) of messages in a mailbox. FIRST RUN: Returns ALL messages in folder (use top=50 to limit). Response has @odata.deltaLink. SUBSEQUENT: Pass stored deltaLink to get only NEW/UPDATED/DELETED messages since last sync. Properties available: id, subject, from, receivedDateTime, isRead, etc. NOT available: internetMessageHeaders, full body, attachment content (response size limits).
Tool to retrieve mail tips such as automatic replies and mailbox full status. Use when you need to check recipient status before sending mail.
Retrieves the Microsoft Outlook profile for a specified user.
Tool to retrieve a specific calendar event from a user's primary calendar. Use when you need detailed information about a particular event for a given user.
Retrieves events from a user's Outlook calendar via Microsoft Graph API. Supports primary/secondary/shared calendars, pagination, filtering, property selection, sorting, and timezone specification. Use calendar_id to access non-primary calendars.
Tool to list messages from a specific mail folder including subfolders. Use when you need to retrieve messages from a particular folder or subfolder by its ID or well-known name.
Tool to list a user's top-level mail folders. Use when you need folders like Inbox, Drafts, Sent Items; set include_hidden_folders=True to include hidden folders.
Tool to list calendars in the signed-in user's mailbox. Use when you need to retrieve calendars with optional OData queries.
Tool to list tasks within a specified Microsoft To Do task list, including status and due dates. Use when retrieving tasks from a specific To Do list.
Tool to list Microsoft To Do task lists for the signed-in user. Use when you need to discover available task lists before listing or creating tasks. Returns todoTaskList objects with id and displayName that can be used in downstream operations.
Move a message to another folder within the specified user's mailbox. Creates a new copy in the destination folder and removes the original. The message_id changes after a successful move; use the ID returned in the response for any subsequent operations on the moved message. High-volume parallel moves can trigger HTTP 429 (MailboxConcurrency) throttling; honor the Retry-After header.
Tool to pin a message in an Outlook chat. Use when you want to mark an important message for quick access.
Query Outlook emails within a SINGLE folder using OData filters. Build precise server-side filters for dates, read status, importance, subjects, attachments, and conversations. Best for structured queries on message metadata within a specific folder. Returns up to 100 messages per request with pagination support. • Searches SINGLE folder only (inbox, sentitems, etc.) - NOT across all folders • For cross-folder/mailbox-wide search: Use OUTLOOK_SEARCH_MESSAGES • Server-side filters: dates, importance, isRead, hasAttachments, subjects, conversationId • CRITICAL: Always check response
Sends a reply to an Outlook email message with optional HTML formatting, identified by `message_id`, allowing optional CC and BCC recipients.
Sends an email with subject, body, recipients, and optional attachments via Microsoft Graph API. Supports comma-separated email addresses in the to_email field for multiple recipients. Accepts either a single file or a list of files as attachments. Attachments require a non-empty file with valid name and mimetype.
Updates specified properties of an existing email message; `message_id` must identify a valid message within the specified `user_id`'s mailbox.
Tool to update mailbox settings for the signed-in user. Use when you need to configure automatic replies, default time zone, language, or working hours. Example: schedule automatic replies for vacation.
Adds an attachment to a specific Outlook calendar event. Use when you need to attach a file or nested item to an existing event.
Tool to cancel a calendar event for a specified user and send cancellation notifications to all attendees. Use when you need to cancel a meeting or event on behalf of a specific user.
Tool to cancel an event in a user's calendar within a calendar group and send cancellation notifications to all attendees. Use when canceling a meeting or event for a specific user in a calendar that belongs to a calendar group.
Tool to cancel an event in a specific calendar for a specified user and send cancellation notifications to all attendees. Use when you need to cancel a meeting or event in a specific calendar on behalf of a user.
Tool to copy a child mail folder to a destination folder. Use when you need to duplicate a folder structure.
Tool to copy an email message from a child folder (nested folder) to another folder within the user's mailbox. Use when duplicating messages from nested folder structures.
Tool to copy a message from a specific user's mail folder to another folder. Use when you need to duplicate a message from a known source folder to a destination folder for a specific user.
Tool to copy a user's mail folder and its contents to another folder. Use when you need to duplicate a folder structure for a specific user's mailbox.
Creates a draft reply in the specified user's Outlook mailbox to an existing message (identified by a valid `message_id`), optionally including a `comment` and CC/BCC recipients.
Tool to create an upload session for large (>3 MB) message attachments. Use when you need to upload attachments in chunks.
Tool to create an upload session for large (>3 MB) message attachments in child mail folders. Use when you need to upload attachments to messages in nested folder structures.
Tool to create a new calendar in the signed-in user's mailbox. Use when organizing events into a separate calendar.
Tool to create a new attachment for an event in a specific calendar. Use when you need to attach a file or item to an event within a particular calendar.
Tool to create an upload session for large calendar event attachments in a specific calendar. Use when attaching files larger than 3 MB to Outlook calendar events in a specific calendar.
Tool to create a new calendar event for a specific user. Use when you need to create events in a user's calendar.
Tool to create a new calendar group for a user. Use when needing to organize calendars into groups.
Tool to create an upload session for large calendar group event attachments. Use when attaching files larger than 3 MB to events in calendar groups.
Tool to create a new calendar in a calendar group for a specific user. Use when organizing events into a separate calendar within a specific calendar group for a user.
Tool to create a calendar permission for a specific calendar in a calendar group. Use when granting access to a calendar for another user.
Tool to create a calendar permission via an event's calendar. Use when granting calendar access through an event by specifying the event ID and user email address.
Tool to create a new open extension on a contact within a child folder. Use when you need to store custom data with a contact.
Tool to create a new contact folder in the user's mailbox. Use when needing to organize contacts into custom folders.
Tool to create a new contact in a child folder within a contact folder. Use when you need to add a contact to a specific nested folder structure.
Tool to create an upload session for large calendar event attachments. Use when attaching files larger than 3 MB to Outlook calendar events.
Tool to create a new open extension on a calendar event within a specific calendar group and calendar. Use when you need to store custom data with an event.
Tool to create a new event in a specific calendar for a user. Use when you need to create events in a specific calendar (e.g., shared or secondary calendars).
Tool to create a draft forward of an existing message. Use when you need to prepare a forward that can be edited before sending. The draft can be updated with recipients and additional content before being sent.
Tool to create a new mail folder. Use when you need to organize email into a new folder.
Tool to add an attachment to a message in a specific mail folder. Use when you need to attach a file to a message located in a particular mail folder.
Tool to create an upload session for large (>3 MB) message attachments in a specific mail folder. Use when you need to upload attachments in chunks to a message located in a mail folder.
Tool to create an upload session for large event attachments. Use when attaching files larger than 3 MB to the authenticated user's Outlook events.
Tool to create an attachment for a message. Use when you need to attach a file or item to an existing message. Supports file attachments, item attachments, and reference attachments.
Tool to create a new message in a specific mail folder. Use when you need to create a draft message in a particular folder (e.g., drafts, custom folders).
Tool to create a new draft message in a child folder within a user's mail folder. Use when creating messages in nested folder structures for a specific user's mailbox.
Deprecated: Use OUTLOOK_CREATE_DRAFT_REPLY instead, which adds comment, cc_emails, and bcc_emails support.
Tool to create a reply draft for a message in a user's mail folder. Use when you need to prepare a reply without sending it immediately. The draft is created in the Drafts folder and includes the RE: prefix in the subject line.
Tool to create a draft reply-all to a message in a child folder. Use when you need to create a draft reply to the sender and all recipients of a message located in a subfolder within a mail folder.
Deprecated: Use OUTLOOK_CREATE_REPLY_ALL_DRAFT instead, which supports both /me and /users/{user_id} endpoints with timezone support.
Tool to create a draft reply-all to a user's message. Use when you need to create a draft reply to the sender and all recipients of an email message in a user's mailbox.
Tool to create a reply-all draft for a message in a mail folder. Use when you need to create a draft reply to all recipients of an email.
Tool to create a new attachment for a user's calendar event. Use when you need to attach a file or item to an existing event in a specific user's calendar.
Tool to create a new attachment for an event in a specific user's calendar. Use when you need to attach a file or item to an event within a particular user's calendar.
Tool to create a new open extension on a calendar event for a specific user. Use when you need to store custom data with an event.
Tool to create a new calendar event in a specific user's calendar within a calendar group. Use when creating events for a particular user in a calendar that belongs to a calendar group.
Tool to create a new attachment for an event in a calendar within a calendar group for a specific user. Use when you need to attach a file or item to an event in a user's calendar group.
Tool to create a new calendar permission for a specific user's calendar. Use when you need to share another user's calendar with someone or grant access with specific permission levels.
Tool to create a new open extension on a contact within a user's contact folder. Use when you need to store custom data with a contact.
Tool to create a new open extension on a specific user's contact. Use when you need to store custom data with a contact for a specific user.
Tool to create a child contact folder within a parent contact folder for a specific user. Use when you need to organize contacts into nested folder hierarchies for a given user.
Tool to create a new contact in a specific user's contact folder. Use when you need to add a contact to a particular folder for a specified user.
Deprecated: Use OUTLOOK_CREATE_ME_EVENT_ATTACHMENT_UPLOAD_SESSION instead, which supports both /me and /users/{user_id} endpoints.
Tool to create a Focused Inbox override for a sender identified by SMTP address for a specific user. Use when you need to configure messages from a specific sender to always be classified as focused or other for a particular user.
Tool to create a new open extension on a message in a user's mail folder. Use when you need to store custom data with a specific message in a user's mailbox.
Tool to create a forward draft of an Outlook message for a specific user. Use when you need to prepare a forward email that can be edited before sending. The draft is created in the Drafts folder with the FW: prefix in the subject line.
Tool to create a message rule in a user's mail folder. Use when automating message processing with filters and actions.
Tool to create a new child folder under a specified mail folder for a user. Use when organizing email into nested folder hierarchies within a specific user's mailbox.
Tool to create a new category in a user's master category list. Use when you need to add a category to organize email and calendar items for a specific user.
Tool to create a new draft message in a user's mailbox. Use when creating draft messages for a specific user or the authenticated user.
Tool to create an attachment on a message in a user's mail folder. Use when you need to attach a file or item to an existing message in a specific user's mailbox.
Tool to create a new open extension on a message in a child mail folder for any user. Use when you need to store custom data with a message in a nested folder structure.
Tool to delete a calendar event from a user's Outlook calendar. Use when removing events that are no longer needed or were created in error.
Tool to delete a calendar group other than the default calendar group. Use when removing unused calendar groups from the mailbox.
Tool to delete an attachment from an event in a calendar within a calendar group. Use when you need to remove a file or item attachment from an event in a specific calendar group.
Tool to delete a message from a child mail folder in Outlook. Use when removing messages from nested folder structures or cleaning up messages in subfolders.
Permanently deletes an existing contact, using its `contact_id` (obtainable via 'List User Contacts' or 'Get Contact'), from the Outlook contacts of the user specified by `user_id`.
Tool to delete a navigation property extension from a contact within a child folder. Use when removing custom extension data from a contact.
Tool to delete an open extension from a contact. Use when removing custom data extensions that are no longer needed.
Tool to delete a contact folder from the user's mailbox. Use when you need to remove an existing contact folder.
Tool to permanently delete a contact from a specific contact folder. Use when removing contacts from organized folders in Outlook.
Tool to delete a contact from a child folder in a user's contact folder. Use when you need to remove a contact from a specific child folder within a contact folder.
Delete an email rule permanently; deletion is irreversible. Confirm rule details with the user before executing. Removing a rule may alter the firing order and stop-processing behavior of remaining rules.
Tool to delete an attachment from an Outlook calendar event. Use when you need to remove a file or item attachment from an existing event.
Tool to delete an open extension from a calendar event in a calendar group. Use when removing custom extension data that is no longer needed.
Tool to delete an event from a specific calendar in Outlook. Use when removing events from secondary or shared calendars by providing both calendar ID and event ID.
Tool to delete an inference classification override for a specific sender. Use when removing custom Focused Inbox rules that were previously set.
Tool to delete a child mail folder from a parent mail folder. Use when removing nested mail folders from a user's mailbox.
Tool to delete a message from a specific mail folder in Outlook. Use when removing messages from a particular folder or cleaning up folder contents.
Tool to delete a message rule from a specific mail folder. Use when you need to remove an email automation rule from a folder.
Tool to delete a category from the user's master category list. Use when removing unused or obsolete categories from the mailbox.
Tool to permanently delete an Outlook email message by its message_id. Use when removing unwanted messages, cleaning up drafts, or performing mailbox maintenance.
Tool to delete an attachment from a message. Use when removing file or item attachments from messages in Outlook.
Tool to delete an attachment from a message in a nested mail folder structure. Use when removing attachments from messages located in child folders within mail folders.
Tool to delete a navigation property extension from a message within a mail folder. Use when removing custom extension data from a message.
Tool to delete an open extension from an Outlook message. Use when removing custom extension data that is no longer needed from a message.
Delete user calendar event attachment
Tool to delete a calendar from a specific user's calendar group in Microsoft Outlook. Use when removing a calendar that belongs to a user's calendar group.
Tool to delete a calendar event from a specific user's calendar within a calendar group. Use when removing events from calendars organized under calendar groups for a specific user.
Tool to delete a calendar permission from a user's calendar within a calendar group. Use when revoking calendar sharing access for specific users.
Tool to delete a calendar permission from a specific user's calendar. Use when revoking calendar sharing access for a particular user.
Tool to delete a calendar permission from a specific user's calendar. Use when revoking access to a shared calendar.
Tool to permanently delete a message from a user's child mail folder in Outlook. Unlike standard DELETE, this action makes the message unrecoverable by moving it to the Purges folder in the dumpster. Use when you need to ensure a message in a nested folder cannot be restored from deleted items.
Deprecated: Use OUTLOOK_DELETE_CONTACTS_EXTENSIONS instead, which supports both /me and /users/{user_id} endpoints.
Tool to delete a child contact folder from a parent contact folder for a specific user. Use when removing nested contact folders from a user's mailbox.
Tool to delete an extension from a contact in a user's contact folder. Use when removing custom extension data from a contact.
Tool to delete an attachment from a user's Outlook event. Use when you need to remove a file or item attachment from an existing event.
Tool to delete an open extension from a user's calendar event. Use when removing custom extension data that is no longer needed.
Deprecated: Use OUTLOOK_DELETE_ME_MESSAGES_ATTACHMENTS instead, which supports both /me and /users/{user_id} endpoints.
Delete user message extension
Tool to dismiss a reminder for a specific calendar event. Use when you need to turn off or remove a reminder alert for an event.
Tool to dismiss a reminder for a specific event in a user's calendar. Use when you need to turn off or remove a reminder alert for an event in a specific user's calendar.
Tool to dismiss a reminder for an event in a user's calendar within a calendar group. Use when you need to turn off a reminder for an event in a specific user's calendar group.
Tool to dismiss a reminder for a specific user's calendar event. Use when you need to turn off or remove a reminder alert for an event in a user's calendar.
Tool to retrieve allowed calendar sharing roles for a specific user on a given calendar. Use when you need to determine what permission levels can be granted to a user for sharing a specific calendar.
Tool to retrieve a specific attachment from a message located in a nested mail folder structure. Use when you need to get attachment details from messages in deeply nested folders.
Tool to retrieve a specific attachment from an event within a calendar. Use when you need to access attachment content from a calendar event.
Tool to retrieve a specific calendar from a calendar group in Microsoft Outlook. Use when you need to get details of a calendar that belongs to a specific calendar group.
Tool to retrieve the parent calendar that contains a specific event. Use when you need to get calendar details for a specific event in a calendar.
Tool to retrieve the properties and relationships of a calendar group object. Use when you need to get details of a specific calendar group by its ID.
Deprecated: Use OUTLOOK_GET_USER_CALENDAR_GROUP_EVENT_ATTACHMENT instead, which supports both /me and /users/{user_id} endpoints.
Tool to get free/busy schedule information for users, distribution lists, or resources. Use when you need to check availability for specific people or resources during a time period.
Tool to get calendar view from a specific calendar within a calendar group for a user. Use when retrieving events from a calendar that belongs to a calendar group.
Tool to get calendar view from a specific user's calendar. Use when you need to retrieve events that occur or overlap with a specified time window from a user's specific calendar by calendar ID.
Tool to retrieve a specific email message from a child mail folder. Use when you need to access a message in a nested folder hierarchy.
Tool to get the MIME content of a message from a child mail folder. Use when you need to download the raw MIME format of an email message for analysis or archival.
Tool to retrieve a specific child mail folder from a parent mail folder. Use when you need details about a specific subfolder within a folder hierarchy.
Tool to retrieve an open extension from a contact in Microsoft Graph. Use when you need to access custom data stored with a contact.
Tool to retrieve a specific contact folder by ID. Use when you need details about a particular contact folder in the user's mailbox.
Tool to retrieve a specific contact from a nested child folder within a contact folder. Use when you need contact details from a child folder.
Tool to retrieve a specific contact from a contact folder by its ID. Use when you need to access contact details from a specific folder rather than the default contacts location.
Tool to get the binary media content of a contact's profile photo. Use when you need to download or retrieve a contact's picture.
Tool to get the drafts mail folder. Use when you need to retrieve details about the drafts folder such as item counts and folder ID.
Retrieves a specific email message by its ID from the specified user's Outlook mailbox. Use the 'select' parameter to include specific fields like 'internetMessageHeaders' for filtering automated emails.
Tool to retrieve a specific attachment from an Outlook calendar event by attachment ID. Use when you need to download or access the content of a particular event attachment.
Tool to retrieve the calendar that contains a specific event. Use when you need to get calendar details for an event.
Tool to retrieve the calendar that contains a specific event within a calendar group. Use when you need to get calendar details for an event in a calendar group.
Tool to retrieve an open extension from a calendar event within a specific calendar group and calendar. Use when you need to access custom data stored with an event.
Tool to retrieve a specific open type extension from a user's calendar event by its extension ID or name. Use when you need to access custom data stored in calendar event extensions.
Tool to retrieve a specific event from a specified calendar. Use when you need to get details of an event that belongs to a specific calendar in the user's mailbox.
Tool to get inference classification settings for the authenticated user. Use when you need to retrieve the Focused Inbox configuration and sender-specific overrides that determine message classification.
Tool to retrieve a mail folder by ID or well-known name. Use when you need to get details about a specific folder such as item counts, size, and folder properties.
Tool to retrieve a specific message from a mail folder by its ID. Use when you need to fetch full message details including subject, body, sender, recipients, timestamps, and other metadata from a specific mail folder.
Tool to retrieve mailbox settings. Use when you need to view settings such as automatic replies, time zone, and working hours for the signed-in or specified user.
Tool to retrieve the user's master category list. Use when you need to get all categories defined for the user.
Tool to retrieve properties of a specific category from the user's master category list. Use when you need details about a specific category.
Tool to retrieve a specific extension from a message in a user's mailbox. Use when you need to read custom data stored in a message extension.
Tool to retrieve a specific message from a child folder within a user's mail folder hierarchy. Use when you need to access messages from nested folders where both parent and child folder IDs are known.
Tool to get the MIME content of a message. Use when you need to download the raw MIME format of an email message for analysis or archival.
Retrieves free/busy schedule information for specified email addresses within a defined time window. Read-only; does not reserve time or prevent conflicts — verify availability before creating events.
Deprecated: Use OUTLOOK_GET_USER_CALENDAR instead, which supports both /me and /users/{user_id} endpoints and adds $select field filtering.
Tool to retrieve supported languages in the user's mailbox. Use when you need to display or select from available mailbox languages.
Tool to get the list of time zones supported for a user as configured on their mailbox server. Use when setting up an Outlook client or configuring user time zone preferences.
Tool to retrieve a specific calendar permission for a user's calendar within a calendar group. Use when you need to check access permissions for a specific calendar.
Tool to retrieve a specific event from a user's calendar within a calendar group. Use when you need details of an event in a specific calendar group.
Tool to retrieve a specific attachment from an event within a calendar group for a user. Use when you need to access attachment content from a calendar event in a user's calendar group.
Tool to retrieve free/busy schedule information for a specific user's calendar within a calendar group. Use when you need availability data from a particular user's calendar that belongs to a calendar group.
Tool to retrieve a specific calendar permission for a user's calendar. Use when you need to check who has access to a specific user's calendar and their permission level.
Tool to retrieve a specific calendar permission from a user's calendar. Use when you need to check who has access to a specific user's calendar and their permission level.
Tool to retrieve a specific child contact folder for a user by ID. Use when you need details of a child folder nested within a parent contact folder for a specific user.
Tool to retrieve a specific open extension from a user's contact. Use when you need to access custom data stored with a contact.
Tool to retrieve a specific attachment from a user's calendar event. Use when you need to access attachment details including content from a specific user's event.
Tool to retrieve a specific message rule from a user's mail folder. Use when you need details about an email rule in a particular user's folder.
Tool to retrieve a specific attachment from a message in a mail folder hierarchy. Use when you need to get attachment details including content from a specific folder path.
Tool to retrieve a specific extension from a user's message. Use when you need to read custom data stored in a message extension.
Tool to retrieve the outlookUser object for a specified user. Use when you need to access the Outlook services entity for a user.
Tool to get the properties and relationships of a specific calendar for a user. Use when you need to retrieve details for a particular calendar by its ID for any user.
Tool to get the properties and relationships of the signed-in user's default calendar. Use when you need to retrieve calendar details for the authenticated user.
Tool to retrieve instances (occurrences) of a recurring event from a specific calendar within a date range. Use when you need event instances from a particular calendar.
Tool to list calendar permissions for a specific calendar within a calendar group. Use when you need to view sharing permissions for a calendar.
Tool to get calendar events that have been added, deleted, or updated in a calendar view. Use when you need to track changes to events within a specific time range.
Tool to retrieve calendars belonging to a specific calendar group. Use when you need to list calendars within a calendar group with optional OData queries.
Tool to list messages in a Teams chat. Use when you need message IDs to select a specific message for further actions.
Tool to list messages from a child folder within a parent mail folder. Use when you need to retrieve messages from a subfolder that exists within another folder.
Tool to list subfolders (childFolders) under a specified Outlook mail folder. Use when navigating nested folder hierarchies or checking if a folder has subfolders.
Tool to list child folders under a specified contact folder. Use when navigating nested contact folder hierarchies or organizing contacts into subfolder structures.
Tool to get contact folders that have been added, deleted, or updated. Use when tracking changes to contact folder structure without fetching all folders each time.
Retrieve incremental changes (delta) of contacts in a specified folder. Use when syncing contacts without fetching the entire set each time. FIRST RUN: Returns ALL contacts in folder. Response has @odata.deltaLink. SUBSEQUENT: Pass stored deltaLink to get only NEW/UPDATED/DELETED contacts since last sync.
List all email rules from inbox. No server-side filtering is supported; all rule narrowing must be done client-side after retrieval. Each rule includes a `sequence` field defining execution order and may include a `stopProcessingRules` flag affecting downstream rule execution.
Tool to list attachments for a specific Outlook calendar event. Use when you have an event ID and need to view its attachments.
Tool to list calendar permissions for the calendar containing a specific event. Use when you need to see who has access to a calendar that contains a particular event.
Tool to retrieve individual occurrences of a recurring calendar event within a specified time range. Use when you need to get specific instances of a recurring meeting or event series.
Tool to list instances (occurrences) of a recurring event within a specified date range from a user's calendar in a calendar group. Use when you need to retrieve specific occurrences of a recurring event.
Tool to retrieve reminders for events occurring within a specified time range. Use when you need to see upcoming reminders between two datetimes.
Tool to list inference classification overrides that control Focused Inbox sender rules. Use when you need to see which senders are configured to always appear in Focused or Other inbox.
Tool to get attachments from a message in a specific mail folder. Use when you need to retrieve attachment metadata from a message located in a particular folder.
Tool to list message rules for a specific mail folder. Use when you need to retrieve rules configured for a particular folder.
Tool to get incremental changes to mail folders. Use when you need to track additions, deletions, or updates to mail folders without fetching the entire folder list each time.
Deprecated: Use OUTLOOK_GET_MASTER_CATEGORIES instead, which adds pagination (top/skip), filtering, field selection, and sorting.
Tool to list attachments from a message in a nested child mail folder. Use when you need to retrieve attachment metadata from a message located in a subfolder.
Lists metadata (name, size, contentType, isInline — but not `contentBytes`) for all attachments of a specified Outlook email message. Returns fileAttachment, itemAttachment, and referenceAttachment types; only fileAttachment entries support download via OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT. Results include inline images and signatures — filter by `isInline == false` and check `contentType` to identify real document attachments. Results are nested under `data.response_data.value`.
Tool to list calendar groups in the signed-in user's mailbox. Use when you need to retrieve calendar groups with optional OData queries.
Retrieves a collection of place objects defined in a tenant by type. Places can include rooms, workspaces, buildings, floors, sections, desks, and room lists. When room_list_id is provided, returns only rooms or workspaces within that specific room list using the /places/{roomListId}/microsoft.graph.roomlist/rooms (or /workspaces) endpoint. Use this action when you need to discover available physical spaces or locations within an organization. Note: Before using this API, ensure that the Places settings are properly configured in the tenant.
Tool to list calendar permissions from a user's primary calendar. Use when you need to see who has access to the primary calendar and their permission levels.
Tool to list all messages in the SentItems mail folder of the signed-in user's mailbox. Use when you need to retrieve sent messages with optional filtering and sorting.
Tool to list Teams chats. Use when you need chat IDs and topics to select a chat for further actions.
Tool to list attachments for a calendar event within a specific calendar for a user. Use when you need to retrieve attachments from an event in a user's specific calendar.
Tool to list attachments for a user's calendar event. Use when you need to retrieve all attachments from a specific event in a user's calendar.
Tool to list events from a specific calendar within a calendar group for a user. Use when you need to retrieve events from a user's calendar that belongs to a specific calendar group.
Tool to list attachments for a calendar event within a specific calendar group for a user. Use when you need to retrieve attachments from an event in a calendar that belongs to a calendar group for a specific user.
Tool to list calendar permissions for a specific user's calendar. Use when you need to see who has access to a user's calendar and their permission levels.
Tool to list calendar permissions for a specific user's specific calendar. Use when you need to see who has access to a user's calendar and their permission levels.
Tool to retrieve events from a specific calendar for a user. Use when you need to list calendar events for a specific user by user ID and calendar ID.
Tool to retrieve contacts from a user's child contact folder. Use when you need to access contacts organized in nested folder structures for a specific user.
Tool to retrieve contact folders from a specific user's mailbox. Use when you need to list or browse contact folders for a given user.
Tool to retrieve contacts from a specific user's mailbox. Use when you need to list or browse contacts for a given user.
Tool to list users in Microsoft Entra ID. Use when you need to retrieve a paginated list of users, optionally filtering or selecting specific properties. For single-user lookups, prefer a dedicated get-user tool — listing all users is significantly heavier and slower.
Tool to move a child mail folder to a different parent folder. Use when you need to reorganize subfolders within the folder hierarchy.
Tool to move a mail folder and its contents to another mail folder. Use when you need to reorganize the folder hierarchy.
Tool to move a message from a child folder to another destination folder. Use when you need to move a message that exists within a specific folder hierarchy (parent folder → child folder → message).
Tool to move a message from a specific mail folder to another destination folder. Use when you need to move a message and know both the source folder ID and the message ID.
Permanently deletes a calendar from a user's mailbox. Unlike standard DELETE, this action makes the calendar permanently unrecoverable. Use when you need to ensure a calendar cannot be restored from deleted items.
Tool to permanently delete a calendar event from a calendar within a calendar group. Use when you need to ensure an event cannot be restored from deleted items.
Permanently deletes a child contact folder. Unlike standard DELETE, this action makes the folder permanently unrecoverable. Use when you need to ensure a child contact folder cannot be restored from deleted items.
Permanently deletes a child mail folder from a parent mail folder. Unlike standard DELETE, this action makes the folder permanently unrecoverable. Use when you need to ensure a child folder cannot be restored from deleted items.
Permanently deletes a contact. Unlike standard DELETE, this action makes the contact permanently unrecoverable. Use when you need to ensure a contact cannot be restored from deleted items.
Permanently deletes a contact folder. Unlike standard DELETE, this action makes the folder permanently unrecoverable. Use when you need to ensure a contact folder cannot be restored from deleted items.
Permanently deletes a contact from a specific contact folder. Unlike standard DELETE, this action makes the contact permanently unrecoverable. Use when you need to ensure a contact in a folder cannot be restored from deleted items.
Permanently deletes a calendar event. Unlike standard DELETE, this action makes the event permanently unrecoverable. Use when you need to ensure an event cannot be restored from deleted items.
Permanently deletes an Outlook message by moving it to the Purges folder in the dumpster. Unlike standard DELETE, this action makes the message unrecoverable by the user. IMPORTANT: This is NOT the same as DELETE - permanentDelete is irreversible and availability differs by national cloud deployments (not available in US Government L4, L5 (DOD), or China (21Vianet)).
Tool to permanently delete a calendar event from a specific user's calendar. Use when you need to ensure an event cannot be restored from deleted items.
Tool to permanently delete a contact from a child folder for a specific user. Use when you need to ensure a contact cannot be restored from deleted items.
Tool to permanently delete a calendar event for a specified user. Use when you need to ensure an event cannot be restored from deleted items.
Permanently deletes a mail folder for a specific user. Unlike standard DELETE, this action makes the folder permanently unrecoverable. Use when you need to ensure a user's folder cannot be restored from deleted items.
Search Outlook messages using powerful KQL syntax. Supports sender (from:), recipient (to:, cc:), subject, date filters (received:, sent:), attachments, and boolean logic. Only works with Microsoft 365/Enterprise accounts (no @hotmail.com/@outlook.com). Examples: 'from:user@example.com AND received>=2025-10-01', 'to:info@jcdn.nl AND subject:invoice', 'received>today-30 AND hasattachment:yes'
Tool to send an existing draft message. Use after creating a draft when you want to deliver it to recipients immediately. Example: Send a draft message with ID 'AAMkAG…'.
Tool to postpone an event reminder until a new time. Use when you need to delay a reminder for a calendar event.
Tool to snooze a reminder for a calendar event in a specific user calendar to a new time. Use when you need to postpone an event reminder for a specific calendar.
Tool to snooze a reminder for a user's calendar event within a calendar group to a new time. Use when you need to postpone an event reminder for a specific user's calendar that belongs to a calendar group.
Tool to snooze a reminder for a user's calendar event to a new time. Use when you need to postpone an event reminder for a specific user.
Updates specified fields of an existing Outlook calendar event. Implementation note: To avoid unintentionally clearing properties, the action first fetches the existing event, merges only the provided fields, and then PATCHes the merged updates. Unspecified fields remain unchanged.
Tool to update the properties of a calendar group object. Use when you need to rename a calendar group.
Tool to update a calendar permission within a calendar group. Use when changing access levels for calendars in specific groups.
Tool to update calendar permission levels for share recipients or delegates. Use when you need to change the access level (role) for someone who has been granted access to a calendar.
Tool to update a contact in a child contact folder within a parent contact folder. Use when you need to modify contact properties such as name, email, phone numbers, or company details for contacts in nested folder structures.
Updates an existing Outlook contact, identified by `contact_id` for the specified `user_id`, requiring at least one other field to be modified.
Tool to update an open extension on a contact in a contact folder. Use when you need to modify custom properties stored in a contact extension.
Tool to update a contact within a specific contact folder. Use when you need to modify contact details for a contact stored in a particular folder.
Update an existing email rule
Tool to update an open extension on a calendar event in Microsoft Graph. Use when you need to modify custom properties stored in an event extension.
Tool to update an open extension on a calendar event within a calendar group. Use when modifying custom properties stored in an event extension for events in calendar groups.
Tool to update an event in a specific Outlook calendar. Use when you need to modify event details like subject, time, attendees, or location in a non-default calendar.
Tool to update the inferenceClassification resource for a user. Use when needing to refresh or sync the Focused Inbox classification settings. Note: The inferenceClassification resource has no writable properties; actual message classification rules are managed through the overrides collection.
Tool to update the display name of a mail folder. Use when you need to rename an existing mail folder.
Tool to update the color of a category in the user's master category list. Use when you need to change the color of an existing category. Note that the display name cannot be modified after creation.
Tool to update the properties of a user's calendar. Use when you need to rename a calendar or change its color theme for a specific user.
Tool to update properties of a specific calendar by ID for a specific user. Use when you need to rename a user's calendar, change its color theme, or set it as the default calendar.
Deprecated: Use OUTLOOK_UPDATE_CALENDAR_EVENT_IN_CALENDAR instead, which supports both /me and /users/{user_id} endpoints and additional fields (is_all_day, importance, sensitivity, reminders).
Tool to update an event in a specific user's calendar. Use when you need to modify calendar event properties for a user other than the signed-in user.
Tool to update an event in a calendar within a calendar group for a specific user. Use when modifying event details for a user's calendar.
Tool to update a calendar within a calendar group in a user's mailbox. Use when modifying calendar properties like name, color, or default calendar status.
Tool to update calendar permission levels for a specific user's calendar. Use when you need to change the access level (role) for someone who has been granted access to a user's calendar.
Tool to update a message in a child folder within a user's mailbox. Use when you need to modify message properties such as isRead status, importance, categories, or subject for messages in nested folder structures for a specific user.
Tool to update an open extension on a contact in a user's contact folder. Use when you need to modify custom properties stored in a contact extension for a specific user.
Tool to update an open extension on a contact in a user's contact folder. Use when you need to modify custom properties stored in a contact extension for a specific user.
Tool to update an open extension on a contact directly under a user's contacts collection. Use when you need to modify custom properties stored in a contact extension.
Tool to update the properties of a contact folder for a specific user. Use when you need to rename or move an existing contact folder.
Tool to update a child folder within a contact folder for a specific user. Use when you need to rename a child contact folder or move it to a different parent folder.
Deprecated: Use OUTLOOK_UPDATE_EVENT_EXTENSION_IN_CALENDAR_GROUP instead, which supports both /me and /users/{user_id} endpoints and uses the correct @odata.type prefix.
Tool to update an open extension on a user's calendar event. Use when modifying custom properties stored in an event extension for a specific user.
Tool to update the classification of messages from a specific sender in a user's Focused Inbox. Use when you need to change whether messages from a sender go to Focused or Other inbox for a specific user.
Tool to update a child folder within a mail folder for a specific user. Use when you need to rename a child mail folder.
Tool to update properties of a message in a specific mail folder for a user. Use when you need to modify message attributes like categories, read status, importance, or other properties for a message within a particular user's folder.
Tool to update a message rule in a user's mail folder. Use when you need to modify an existing rule's properties, conditions, actions, or exceptions for a specific user.
Tool to update an open extension on a message within a specific user's mail folder. Use when you need to modify custom properties stored in a message extension for a specific user.
Tool to update an open extension on a user's message. Use when you need to modify custom properties stored in a message extension for a specific user.
Triggers
These are the trigger events currently available for Outlook.
Triggered when a new calendar event occurs (created, updated, or deleted) in the Outlook calendar.
Triggered when a new calendar event is created in the Outlook calendar.
Triggered when a new contact is added in the Outlook contacts.
Triggered when a new message is received in the Outlook mailbox.
Triggered when a new message is sent from the Outlook mailbox.