Outlook

301 tools available · 5 triggers

Outlook is Microsoft's email and calendaring platform integrating contacts and scheduling, enabling users to manage communications and events in a unified workspace

email calendar

Connect Outlook Visit Outlook ↗

Connect Outlook to Definable to triage inboxes, draft and queue follow-ups, classify and route incoming threads. Personas call Outlook's 301 tools (and react to 5 triggers) directly from chat or scheduled flows. Hand off to an email persona to triage, draft, and route — with you in the loop on every outbound.

Common workflows with Outlook

Inbox triage

Read incoming threads
Classify by intent + urgency
Draft replies for review

Auto-follow-up

Detect emails awaiting reply for 3+ days
Draft contextual nudges
Queue for one-click send

Lead capture

Listen for inbound from a form alias
Extract details
Push to the CRM

Outlook actions 301

Every Outlook action below is a callable tool any Definable persona can invoke.

Accept calendar event invite

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.

Add event attachment

Adds an attachment to a specific Outlook calendar event. Use when you need to attach a file or nested item to an existing event.

Add mail attachment

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 messages

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 messages

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.

Create Calendar Event

Creates a new Outlook calendar event, ensuring `start_datetime` is chronologically before `end_datetime`.

Cancel user's calendar event

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.

Cancel user calendar group event

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.

Cancel user calendar 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.

Copy user's mail folder

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.

Copy child mail folder

Tool to copy a child mail folder to a destination folder. Use when you need to duplicate a folder structure.

Copy message to folder

Tool to copy an email message to another folder within the user's mailbox. Use when duplicating messages to multiple folders for organization.

Copy message from child folder

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.

Copy user message from folder

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.

Create attachment upload session

Tool to create an upload session for large (>3 MB) message attachments. Use when you need to upload attachments in chunks.

Create attachment upload session in child folder

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.

Create calendar

Tool to create a new calendar in the signed-in user's mailbox. Use when organizing events into a separate calendar.

Create Event in Calendar (Deprecated)

DEPRECATED: Use OUTLOOK_CREATE_USER_CALENDAR_CALENDAR_EVENT instead. Tool to create a new event in a specific Outlook calendar. Use when you need to add an event to a particular calendar by its ID.

Create calendar event attachment

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.

Create calendar event attachment upload session

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.

Create event in specific calendar

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

Create calendar group

Tool to create a new calendar group for a user. Use when needing to organize calendars into groups.

Create user calendar group event attachment

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.

Create event extension

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.

Create Calendar Permission

Tool to create a calendar permission for a specific calendar in a calendar group. Use when granting access to a calendar for another user.

Create calendar group event attachment upload session

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.

Create contact

Creates a new contact in a Microsoft Outlook user's contacts folder.

Create contact folder

Tool to create a new contact folder in the user's mailbox. Use when needing to organize contacts into custom folders.

Create user contact folder child folder

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.

Create email draft

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 a draft reply

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.

Create Email Rule

Create email rule filter with conditions and actions

Create user calendar event attachment

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.

Create event attachment upload session

Tool to create an upload session for large calendar event attachments. Use when attaching files larger than 3 MB to Outlook calendar events.

Create user mail folder message forward draft

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.

Create mail folder

Tool to create a new mail folder. Use when you need to organize email into a new folder.

Create message in mail folder

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

Create mail folder message attachment

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.

Create mail folder message attachment upload session

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.

Create User Mail Folder Message Rule

Tool to create a message rule in a user's mail folder. Use when automating message processing with filters and actions.

Create master category (Deprecated)

DEPRECATED: Use OUTLOOK_CREATE_USER_MASTER_CATEGORY instead. Tool to create a new category in the user's master category list. Use after selecting a unique display name.

Create user calendar event extension

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.

Create user calendar permission

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.

Create message in user's child folder

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.

Create user contact in folder

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.

Create user contact extension

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.

Create contact extension

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.

Create contact in child folder

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.

Create calendar event for user

Tool to create a new calendar event for a specific user. Use when you need to create events in a user's calendar.

Create me event attachment upload session

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.

Create forward draft

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.

Create user Focused Inbox override

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.

Create reply-all draft for mail folder message

Deprecated: Use OUTLOOK_CREATE_REPLY_ALL_DRAFT instead, which supports both /me and /users/{user_id} endpoints with timezone support.

Create reply-all draft for user message

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.

Create reply-all draft for child folder message

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.

Create reply draft

Deprecated: Use OUTLOOK_CREATE_DRAFT_REPLY instead, which adds comment, cc_emails, and bcc_emails support.

Create message attachment

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.

Create reply-all draft in folder

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.

Create To Do task

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.

Create user calendar event attachment

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.

Create calendar in user's calendar group

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.

Create user calendar group 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.

Create user contact extension

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.

Create user event attachment upload session

Deprecated: Use OUTLOOK_CREATE_ME_EVENT_ATTACHMENT_UPLOAD_SESSION instead, which supports both /me and /users/{user_id} endpoints.

Create calendar permission via event

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.

Create user message extension

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.

Create user mail folder message extension

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.

Create reply draft for user mail folder message

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.

Create user mail folders child folders

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.

Create user master category

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.

Create user message

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.

Create user message attachment

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.

Decline calendar event

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.

Delete calendar

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 calendar event

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.

Delete user calendar event attachment

Delete event from specific calendar

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.

Delete user calendar group calendar

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.

Delete calendar group

Tool to delete a calendar group other than the default calendar group. Use when removing unused calendar groups from the mailbox.

Delete user calendar group calendar event

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.

Delete calendar group event attachment

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.

Permanently Delete Calendar Group Event

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 Delete Calendar

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.

Delete User Calendar Group Calendar Permission

Tool to delete a calendar permission from a user's calendar within a calendar group. Use when revoking calendar sharing access for specific users.

Permanently Delete Child Contact Folder

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.

Delete Child Folder Message

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.

Delete Contact

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

Delete contact folder

Tool to delete a contact folder from the user's mailbox. Use when you need to remove an existing contact folder.

Delete user contact folder child folder

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.

Delete Contact from Folder

Tool to permanently delete a contact from a specific contact folder. Use when removing contacts from organized folders in Outlook.

Permanently Delete Contact Folder

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 Delete User Contact from Child Folder

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.

Permanently Delete Contact from Folder

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 Delete Contact

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.

Delete contact extension

Tool to delete a navigation property extension from a contact within a child folder. Use when removing custom extension data from a contact.

Delete Email Rule

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.

Delete calendar event (Deprecated)

DEPRECATED: Use OUTLOOK_DELETE_CALENDAR_EVENT instead. Tool to delete an event from the user's calendar. Use when removing calendar events. If this is a meeting, deleting it removes it from the organizer's calendar and sends a cancellation message to all attendees. Require explicit user confirmation before calling this action.

Delete event attachment

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.

Delete event extension

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.

Permanently Delete Event

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.

Delete mail folder

Delete a mail folder from the user's mailbox. Use when you need to remove an existing mail folder.

Delete Mail Folder Message

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.

Delete master category

Tool to delete a category from the user's master category list. Use when removing unused or obsolete categories from the mailbox.

Delete User Calendars Calendar Permission

Tool to delete a calendar permission from a specific user's calendar. Use when revoking access to a shared calendar.

Delete contact extension

Tool to delete an open extension from a contact. Use when removing custom data extensions that are no longer needed.

Delete user contact folder contact extension

Tool to delete an extension from a contact in a user's contact folder. Use when removing custom extension data from a contact.

Delete user event extension

Tool to delete an open extension from a user's calendar event. Use when removing custom extension data that is no longer needed.

Delete user event attachment

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.

Delete inference classification override

Tool to delete an inference classification override for a specific sender. Use when removing custom Focused Inbox rules that were previously set.

Delete mail folder child folder

Tool to delete a child mail folder from a parent mail folder. Use when removing nested mail folders from a user's mailbox.

Permanently Delete Child Mail Folder

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.

Delete mail folder message rule

Tool to delete a message rule from a specific mail folder. Use when you need to remove an email automation rule from a folder.

Delete user message extension

Delete Message Attachment (Deprecated)

DEPRECATED: Use OUTLOOK_DELETE_MESSAGE_ATTACHMENT instead. Tool to delete an attachment from a message in a mail folder. Use when removing file or item attachments from messages in Outlook mail folders.

Delete message extension

Tool to delete a navigation property extension from a message within a mail folder. Use when removing custom extension data from a message.

Delete Message Attachment

Tool to delete an attachment from a message. Use when removing file or item attachments from messages in Outlook.

Delete Message

Tool to permanently delete an Outlook email message by its message_id. Use when removing unwanted messages, cleaning up drafts, or performing mailbox maintenance.

Delete Message Attachment

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.

Delete message extension

Tool to delete an open extension from an Outlook message. Use when removing custom extension data that is no longer needed from a message.

Permanently Delete Message (Folder-Scoped) (Deprecated)

DEPRECATED: Use OUTLOOK_PERMANENT_DELETE_MESSAGE instead. Tool to permanently delete a message from a specific mail folder. Use when you need to irreversibly delete a message with explicit folder context. The message is moved to the Purges folder and cannot be recovered.

Delete User Calendar Permission

Tool to delete a calendar permission from a specific user's calendar. Use when revoking calendar sharing access for a particular user.

Permanently Delete User Calendar Event

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.

Delete Contact from User's Child Folder

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 User Child Folder Message Permanently

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.

Delete user contact extension

Deprecated: Use OUTLOOK_DELETE_CONTACTS_EXTENSIONS instead, which supports both /me and /users/{user_id} endpoints.

Permanently Delete User Event

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 Delete User Mail Folder

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.

Delete user message attachment

Deprecated: Use OUTLOOK_DELETE_ME_MESSAGES_ATTACHMENTS instead, which supports both /me and /users/{user_id} endpoints.

Dismiss user calendar event reminder

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.

Dismiss event reminder

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.

Dismiss user calendar group event reminder

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.

Dismiss user event reminder

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.

Download Outlook attachment

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.

Find Meeting Times

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.

Forward message

Tool to forward a message. Use when you need to send an existing email to new recipients.

Forward user calendar event

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.

Get specific calendar

Deprecated: Use OUTLOOK_GET_USER_CALENDAR instead, which supports both /me and /users/{user_id} endpoints and adds $select field filtering.

Get event from calendar

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.

Get calendar event attachment

Tool to retrieve a specific attachment from an event within a calendar. Use when you need to access attachment content from a calendar event.

Get calendar from event

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.

Get calendar from calendar group

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.

Get calendar group

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.

Get event extension

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.

Get calendar group event attachment

Deprecated: Use OUTLOOK_GET_USER_CALENDAR_GROUP_EVENT_ATTACHMENT instead, which supports both /me and /users/{user_id} endpoints.

Get User Calendar Group Schedule

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.

Get user calendar permission

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.

Get user calendar permission

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.

Get Calendar Schedule

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.

Get Calendar View

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.

Get child folder message

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.

Get child folder message MIME content

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.

Get child mail folder

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.

Get contact extension

Tool to retrieve an open extension from a contact in Microsoft Graph. Use when you need to access custom data stored with a contact.

Get contact folder

Tool to retrieve a specific contact folder by ID. Use when you need details about a particular contact folder in the user's mailbox.

List user contact folders

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.

Get contact from 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.

Get drafts mail folder

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.

Get calendar event

Retrieves the full details of a specific calendar event by its ID from a user's Outlook calendar, provided the event exists.

Get event attachment

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.

Get event calendar from calendar group

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.

Get inference classification

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.

Get mailbox settings

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.

Get mail delta

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

Get mail folder

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.

Get mail folder message

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.

Get user mail folder message rule

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.

Get mail tips

Tool to retrieve mail tips such as automatic replies and mailbox full status. Use when you need to check recipient status before sending mail.

Get master categories

Tool to retrieve the user's master category list. Use when you need to get all categories defined for the user.

Get master category

Tool to retrieve properties of a specific category from the user's master category list. Use when you need details about a specific category.

Get user's default calendar

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.

Get user child contact folder

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.

Get contact from child folder

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.

Get contact photo

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.

Get contact

Retrieves a specific Outlook contact by its `contact_id` from the contacts of a specified `user_id` (defaults to 'me' for the authenticated user).

Get user contact extension

Tool to retrieve a specific open extension from a user's contact. Use when you need to access custom data stored with a contact.

Get user event attachment

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.

Get event calendar

Tool to retrieve the calendar that contains a specific event. Use when you need to get calendar details for an event.

Get mail folder message attachment (Deprecated)

DEPRECATED: Use OUTLOOK_GET_USER_MESSAGES_ATTACHMENTS instead. Tool to get a specific attachment from a message in a mail folder. Use when you have the folder ID, message ID, and attachment ID.

Get message extension

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.

Get message MIME content

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.

Get user outlook

Tool to retrieve the outlookUser object for a specified user. Use when you need to access the Outlook services entity for a user.

Get email message

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.

Get user message extension

Tool to retrieve a specific extension from a user's message. Use when you need to read custom data stored in a message extension.

Get attachment from nested folder message

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.

Get Outlook profile

Retrieves the Microsoft Outlook profile for a specified user.

Get schedule

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.

Get supported languages

Tool to retrieve supported languages in the user's mailbox. Use when you need to display or select from available mailbox languages.

Get supported time zones

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.

Get user's calendar

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.

Get allowed calendar sharing roles for user 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.

Get user calendar event

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.

Get user calendar group calendar permission

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.

Get user calendar group event

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.

Get user calendar group event attachment

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.

Get message from child folder

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.

Get event extension

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.

Get user message attachment

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.

List Calendar Calendar View (Deprecated)

DEPRECATED: Use OUTLOOK_LIST_ME_CALENDARS_CALENDAR_VIEW instead. Tool to list calendar events within a specified date/time range. Use when you need to retrieve events from the user's primary calendar that fall within a time window.

List user calendar event attachments

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.

List user calendar group calendar events

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.

List calendars in calendar group

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.

List user calendar group event attachments

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.

List Outlook calendar groups

Tool to list calendar groups in the signed-in user's mailbox. Use when you need to retrieve calendar groups with optional OData queries.

List calendar permissions

Tool to list calendar permissions for a specific calendar within a calendar group. Use when you need to view sharing permissions for a calendar.

List Outlook calendars

Tool to list calendars in the signed-in user's mailbox. Use when you need to retrieve calendars with optional OData queries.

List calendar view delta

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.

List chat messages

Tool to list messages in a Teams chat. Use when you need message IDs to select a specific message for further actions.

List Teams chats

Tool to list Teams chats. Use when you need chat IDs and topics to select a chat for further actions.

List user child folder contacts

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.

List child folder messages

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.

List child mail folders

Tool to list subfolders (childFolders) under a specified Outlook mail folder. Use when navigating nested folder hierarchies or checking if a folder has subfolders.

List contact folder child folders

Tool to list child folders under a specified contact folder. Use when navigating nested contact folder hierarchies or organizing contacts into subfolder structures.

List contact folders delta

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.

List Outlook contacts (Deprecated)

DEPRECATED: Use OUTLOOK_LIST_USER_CONTACTS instead. Retrieves a user's Microsoft Outlook contacts, from the default or a specified contact folder.

List contacts delta

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 Email Rules

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.

List event attachments

Tool to list attachments for a specific Outlook calendar event. Use when you have an event ID and need to view its attachments.

List event calendar permissions

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.

List event instances

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.

List events

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.

List Inference Classification Overrides

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.

List mail folder message attachments

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.

List mail folder message rules

Tool to list message rules for a specific mail folder. Use when you need to retrieve rules configured for a particular folder.

List mail folder messages

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.

List mail folders

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.

List mail folders delta

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.

List master categories

Deprecated: Use OUTLOOK_GET_MASTER_CATEGORIES instead, which adds pagination (top/skip), filtering, field selection, and sorting.

List user calendar permissions

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.

List me event instances (Deprecated)

DEPRECATED: Use OUTLOOK_LIST_EVENT_INSTANCES instead. 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 from the authenticated user's primary calendar.

List message attachments from child folder

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.

List Messages

Retrieves a list of email messages from a specified mail folder in an Outlook mailbox, with options for filtering (including by conversationId to get all messages in a thread), pagination, and sorting; ensure 'user_id' and 'folder' are valid, and all date/time strings are in ISO 8601 format.

List Outlook attachments

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

List places

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.

List primary calendar permissions

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.

List event reminders

Tool to retrieve reminders for events occurring within a specified time range. Use when you need to see upcoming reminders between two datetimes.

List sent items messages

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.

List To Do task lists

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.

List tasks from a To Do list

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.

List calendar event instances

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.

List user calendar event attachments

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.

List event instances

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.

Get Calendar View from User Calendar Group

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.

List user calendar permissions

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.

List user calendars events

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.

Get calendar view from user's calendar

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.

List user contacts

Tool to retrieve contacts from a specific user's mailbox. Use when you need to list or browse contacts for a given user.

List users

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.

Move mail folder

Tool to move a mail folder and its contents to another mail folder. Use when you need to reorganize the folder hierarchy.

Move child mail folder

Tool to move a child mail folder to a different parent folder. Use when you need to reorganize subfolders within the folder hierarchy.

Move message to folder

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.

Move message from child folder

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

Move message from folder

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 Delete Message

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

Pin message

Tool to pin a message in an Outlook chat. Use when you want to mark an important message for quick access.

Query Emails

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['@odata.nextLink'] for pagination • Limitations: Recipient/body filtering requires OUTLOOK_SEARCH_MESSAGES

Reply to Email

Sends a plain text reply to an Outlook email message, identified by `message_id`, allowing optional CC and BCC recipients.

Search Outlook messages

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:[email protected] AND received>=2025-10-01', 'to:[email protected] AND subject:invoice', 'received>today-30 AND hasattachment:yes'

Send draft

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…'.

Send email

Sends an email with subject, body, recipients, and an optional attachment via Microsoft Graph API. Supports comma-separated email addresses in the to_email field for multiple recipients. Attachments require a non-empty file with valid name and mimetype.

Snooze user calendar group event reminder

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.

Snooze event reminder

Tool to postpone an event reminder until a new time. Use when you need to delay a reminder for a calendar event.

Snooze user calendar event reminder

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.

Snooze user event reminder

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.

Update calendar event

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.

Update event in specific calendar

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.

Update calendar group

Tool to update the properties of a calendar group object. Use when you need to rename a calendar group.

Update Calendar Group Calendar Permission

Tool to update a calendar permission within a calendar group. Use when changing access levels for calendars in specific groups.

Update user calendar in calendar group

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.

Update user calendar group event

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.

Update calendar permission

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.

Update child folder contact

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.

Update Contact

Updates an existing Outlook contact, identified by `contact_id` for the specified `user_id`, requiring at least one other field to be modified.

Update user contact folder

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.

Update user contact folder child 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.

Update contact in folder

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 email message

Updates specified properties of an existing email message; `message_id` must identify a valid message within the specified `user_id`'s mailbox.

Update Email Rule

Update an existing email rule

Update event extension

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.

Update event extension in calendar group

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.

Update Inference Classification

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.

Update mailbox settings

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.

Update mail folder

Tool to update the display name of a mail folder. Use when you need to rename an existing mail folder.

Update master category

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.

Update contact extension

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.

Update user calendar

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.

Update user calendar event

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

Update user calendar event

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.

Update user calendar permission

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.

Update user calendar by ID

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.

Update user child folder message

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.

Update user contact extension

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.

Update user contact extension

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.

Update user contact extension (v3)

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.

Update user event extension

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.

Update user events extensions

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.

Update User Inference Classification Override

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.

Update user mail folder message

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.

Update user message extension

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.

Update user mail folder message rule

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.

Update user mail folder child folder

Tool to update a child folder within a mail folder for a specific user. Use when you need to rename a child mail folder.

Update user message extension

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.

Frequently asked questions

What can I automate with Outlook on Definable?

Anything Outlook exposes through its API. Common email workflows on Definable include triage inboxes, draft and queue follow-ups, classify and route incoming threads. Personas can call any of the 301 Outlook tools directly, or react to its 5 triggers, then chain the result into another integration without you writing code.

How does Outlook authentication work?

Outlook uses OAUTH2, S2S_OAUTH2 on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Outlook integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 301 Outlook tools. You only need a separate Outlook subscription if Outlook itself charges per seat or per API call.

Is using Outlook through Definable secure?

Every call from a persona to Outlook is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Outlook on Definable?

Sign up for Definable, open the integrations page, find Outlook, and connect via OAuth or API key. You can immediately attach Outlook to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Outlook actions does Definable expose?

Definable exposes all 301 Outlook actions as callable tools — including `Accept calendar event invite`, `Add event attachment`, `Add mail attachment`, plus 298 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Outlook?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations