> ## Documentation Index
> Fetch the complete documentation index at: https://squad.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Outlook
> What agents can do in Outlook at each access level, and how to connect, limit, and disconnect Outlook.
Connect Outlook so your agents can work in your Outlook account. You choose an access level for each account, and Squad refuses any agent action outside that level.
## Access levels
Each Outlook account has an access level: **Read-only**, **Read + send**, and **Full access**. Squad refuses any agent action outside that level. You can also narrow or block single agents under **Per-agent access**.
| Level | The connect window describes this level as | Actions agents can use |
| ----------------------------- | ------------------------------------------------------ | ---------------------- |
| **Read-only** | "Read Outlook mail. Cannot send, reply, or delete." | 84 of 306 |
| **Read + send** | "Read mail and send new emails." | 245 of 306 |
| **Full access** (recommended) | "Read, send, organize folders, manage drafts, delete." | 306 of 306 |
**Full access** is the recommended level. The connect window selects it for you, and you can choose another level.
The Outlook sign-in page asks you to approve full access to your account. This is expected. Squad does not narrow the sign-in. It checks every agent action against the level you chose, and it refuses actions outside that level.
## What agents can do at each level
Each level opens with a short summary in plain tasks, then lists every action it adds, grouped by what the action works on. You do not need to name actions. Ask in plain words, and the agent searches for the matching action.
**Find an action.** Open a level and use your browser's find (Ctrl+F, or Cmd+F on a Mac) with a word from the task or part of a slug. Or ask your agent in plain words, for example "What can you do in my Outlook account?" The agent can search the Outlook actions for you.
Each action shows its name, a one-line description where the Outlook action catalog has one, and its slug. The slug is the ID that agents use when they call the action.
Agents can use 84 of the 306 Outlook actions at this level:
* View attachments
* View roles and permissions
* View calendars
* View mail folders
* View extensions
* View emails
* View change history
* View contacts
* View events
* View rules
* View views
* View categories
All 84 actions at this level:
| Action | What it does | Slug |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| Get calendar event attachment | Retrieve a specific attachment from an event within a calendar. | `OUTLOOK_GET_CALENDAR_EVENT_ATTACHMENT` |
| Get calendar group event attachment | Deprecated: Use OUTLOOK\_GET\_USER\_CALENDAR\_GROUP\_EVENT\_ATTACHMENT instead, which supports both /me and /users/\{user\_id} endpoints. | `OUTLOOK_GET_CALENDAR_GROUP_EVENT_ATTACHMENT` |
| Get event attachment | Retrieve a specific attachment from an Outlook calendar event by attachment ID. | `OUTLOOK_GET_EVENT_ATTACHMENT` |
| Get me event attachment | Retrieve a specific attachment from a user's calendar event. | `OUTLOOK_GET_ME_EVENT_ATTACHMENT` |
| Get me mail folder message attachment | DEPRECATED: Use OUTLOOK\_GET\_USER\_MESSAGES\_ATTACHMENTS instead. | `OUTLOOK_GET_ME_MAIL_FOLDER_MESSAGE_ATTACHMENT` |
| Get nested folder message attachment | Retrieve a specific attachment from a message located in a nested mail folder structure. | `OUTLOOK_GET_NESTED_FOLDER_MESSAGE_ATTACHMENT` |
| Get user calendar group event attachment | Retrieve a specific attachment from an event within a calendar group for a user. | `OUTLOOK_GET_USER_CALENDAR_GROUP_EVENT_ATTACHMENT` |
| Get user messages attachments | Retrieve a specific attachment from a message in a mail folder hierarchy. | `OUTLOOK_GET_USER_MESSAGES_ATTACHMENTS` |
| List calendar event attachments | List attachments for a calendar event within a specific calendar for a user. | `OUTLOOK_LIST_CALENDAR_EVENT_ATTACHMENTS` |
| List calendar group event attachments | List attachments for a calendar event within a specific calendar group for a user. | `OUTLOOK_LIST_CALENDAR_GROUP_EVENT_ATTACHMENTS` |
| List event attachments | List attachments for a specific Outlook calendar event. | `OUTLOOK_LIST_EVENT_ATTACHMENTS` |
| List mail folder message attachments | Get attachments from a message in a specific mail folder. | `OUTLOOK_LIST_MAIL_FOLDER_MESSAGE_ATTACHMENTS` |
| List message attachments from child folder | List attachments from a message in a nested child mail folder. | `OUTLOOK_LIST_MESSAGE_ATTACHMENTS_FROM_CHILD_FOLDER` |
| List user calendar events attachments | List attachments for a user's calendar event. | `OUTLOOK_LIST_USER_CALENDAR_EVENTS_ATTACHMENTS` |
| Action | What it does | Slug |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| Get calendar | Deprecated: Use OUTLOOK\_GET\_USER\_CALENDAR instead, which supports both /me and /users/\{user\_id} endpoints and adds \$select field filtering. | `OUTLOOK_GET_CALENDAR` |
| Get calendar from event | Retrieve the parent calendar that contains a specific event. | `OUTLOOK_GET_CALENDAR_FROM_EVENT` |
| Get calendar from group | Retrieve a specific calendar from a calendar group in Microsoft Outlook. | `OUTLOOK_GET_CALENDAR_FROM_GROUP` |
| Get event calendar from group | Retrieve the calendar that contains a specific event within a calendar group. | `OUTLOOK_GET_EVENT_CALENDAR_FROM_GROUP` |
| Get me calendar | Get the properties and relationships of the signed-in user's default calendar. | `OUTLOOK_GET_ME_CALENDAR` |
| Get me event calendar | Retrieve the calendar that contains a specific event. | `OUTLOOK_GET_ME_EVENT_CALENDAR` |
| Get user calendar | Get the properties and relationships of a specific calendar for a user. | `OUTLOOK_GET_USER_CALENDAR` |
| List calendar group calendars | Retrieve calendars belonging to a specific calendar group. | `OUTLOOK_LIST_CALENDAR_GROUP_CALENDARS` |
| Action | What it does | Slug |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- |
| Get master category | Retrieve properties of a specific category from the user's master category list. | `OUTLOOK_GET_MASTER_CATEGORY` |
| List master categories | Deprecated: Use OUTLOOK\_GET\_MASTER\_CATEGORIES instead, which adds pagination (top/skip), filtering, field selection, and sorting. | `OUTLOOK_LIST_MASTER_CATEGORIES` |
| Action | What it does | Slug |
| -------------------------- | --------------------------------------------------------------------------------- | ------------------------------------ |
| List calendar view delta | Get calendar events that have been added, deleted, or updated in a calendar view. | `OUTLOOK_LIST_CALENDAR_VIEW_DELTA` |
| List contact folders delta | Get contact folders that have been added, deleted, or updated. | `OUTLOOK_LIST_CONTACT_FOLDERS_DELTA` |
| List contacts delta | Retrieve incremental changes (delta) of contacts in a specified folder. | `OUTLOOK_LIST_CONTACTS_DELTA` |
| List mail folders delta | Get incremental changes to mail folders. | `OUTLOOK_LIST_MAIL_FOLDERS_DELTA` |
| Action | What it does | Slug |
| -------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------ |
| Get contact from folder | Retrieve a specific contact from a contact folder by its ID. | `OUTLOOK_GET_CONTACT_FROM_FOLDER` |
| Get me contact from child folder | Retrieve a specific contact from a nested child folder within a contact folder. | `OUTLOOK_GET_ME_CONTACT_FROM_CHILD_FOLDER` |
| List child folder contacts | Retrieve contacts from a user's child contact folder. | `OUTLOOK_LIST_CHILD_FOLDER_CONTACTS` |
| List user contacts | Retrieve contacts from a specific user's mailbox. | `OUTLOOK_LIST_USER_CONTACTS` |
| Action | What it does | Slug |
| -------------------------------- | ----------------------------------------------------------- | ------------------------------------------ |
| Get child folder message content | Get the MIME content of a message from a child mail folder. | `OUTLOOK_GET_CHILD_FOLDER_MESSAGE_CONTENT` |
| Get me message mime content | Get the MIME content of a message. | `OUTLOOK_GET_ME_MESSAGE_MIME_CONTENT` |
| Action | What it does | Slug |
| ----------------------------- | -------------------------------------------------------------------------------------- | --------------------------------------- |
| Get child folder message | Retrieve a specific email message from a child mail folder. | `OUTLOOK_GET_CHILD_FOLDER_MESSAGE` |
| Get mail folder message | Retrieve a specific message from a mail folder by its ID. | `OUTLOOK_GET_MAIL_FOLDER_MESSAGE` |
| Get user child folder message | Retrieve a specific message from a child folder within a user's mail folder hierarchy. | `OUTLOOK_GET_USER_CHILD_FOLDER_MESSAGE` |
| List child folder messages | List messages from a child folder within a parent mail folder. | `OUTLOOK_LIST_CHILD_FOLDER_MESSAGES` |
| List sent items messages | List all messages in the SentItems mail folder of the signed-in user's mailbox. | `OUTLOOK_LIST_SENT_ITEMS_MESSAGES` |
| Action | What it does | Slug |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| Get calendar event | Retrieve a specific event from a specified calendar. | `OUTLOOK_GET_CALENDAR_EVENT` |
| Get user calendar group event | Retrieve a specific event from a user's calendar within a calendar group. | `OUTLOOK_GET_USER_CALENDAR_GROUP_EVENT` |
| List calendar group calendar events | List events from a specific calendar within a calendar group for a user. | `OUTLOOK_LIST_CALENDAR_GROUP_CALENDAR_EVENTS` |
| List event instances | Retrieve individual occurrences of a recurring calendar event within a specified time range. | `OUTLOOK_LIST_EVENT_INSTANCES` |
| List me event instances | DEPRECATED: Use OUTLOOK\_LIST\_EVENT\_INSTANCES instead. | `OUTLOOK_LIST_ME_EVENT_INSTANCES` |
| List user calendar event instances | Retrieve instances (occurrences) of a recurring event from a specific calendar within a date range. | `OUTLOOK_LIST_USER_CALENDAR_EVENT_INSTANCES` |
| List user calendar group event instances | List instances (occurrences) of a recurring event within a specified date range from a user's calendar in a calendar group. | `OUTLOOK_LIST_USER_CALENDAR_GROUP_EVENT_INSTANCES` |
| List user calendars events | Retrieve events from a specific calendar for a user. | `OUTLOOK_LIST_USER_CALENDARS_EVENTS` |
| Action | What it does | Slug |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| Get calendar group calendar event extension | Retrieve an open extension from a calendar event within a specific calendar group and calendar. | `OUTLOOK_GET_CALENDAR_GROUP_CALENDAR_EVENT_EXTENSION` |
| Get contact extension | Retrieve an open extension from a contact in Microsoft Graph. | `OUTLOOK_GET_CONTACT_EXTENSION` |
| Get me contacts extensions | Retrieve a specific open extension from a user's contact. | `OUTLOOK_GET_ME_CONTACTS_EXTENSIONS` |
| Get me mail folders messages extensions | Retrieve a specific extension from a message in a user's mailbox. | `OUTLOOK_GET_ME_MAIL_FOLDERS_MESSAGES_EXTENSIONS` |
| Get message extension | Retrieve a specific extension from a user's message. | `OUTLOOK_GET_MESSAGE_EXTENSION` |
| Get user event extension | Retrieve a specific open type extension from a user's calendar event by its extension ID or name. | `OUTLOOK_GET_USER_EVENT_EXTENSION` |
| Action | What it does | Slug |
| -------------------- | --------------------------------------------------------------------- | ------------------------------ |
| Get calendar group | Retrieve the properties and relationships of a calendar group object. | `OUTLOOK_GET_CALENDAR_GROUP` |
| List calendar groups | List calendar groups in the signed-in user's mailbox. | `OUTLOOK_LIST_CALENDAR_GROUPS` |
| Action | What it does | Slug |
| ----------------------------------- | ---------------------------------------------------------------- | --------------------------------------------- |
| Get child mail folder | Retrieve a specific child mail folder from a parent mail folder. | `OUTLOOK_GET_CHILD_MAIL_FOLDER` |
| Get contact folder | Retrieve a specific contact folder by ID. | `OUTLOOK_GET_CONTACT_FOLDER` |
| Get contact folders | Retrieve contact folders from a specific user's mailbox. | `OUTLOOK_GET_CONTACT_FOLDERS` |
| Get drafts mail folder | Get the drafts mail folder. | `OUTLOOK_GET_DRAFTS_MAIL_FOLDER` |
| Get mail folder | Retrieve a mail folder by ID or well-known name. | `OUTLOOK_GET_MAIL_FOLDER` |
| Get me contact folders child folder | Retrieve a specific child contact folder for a user by ID. | `OUTLOOK_GET_ME_CONTACT_FOLDERS_CHILD_FOLDER` |
| List contact folder child folders | List child folders under a specified contact folder. | `OUTLOOK_LIST_CONTACT_FOLDER_CHILD_FOLDERS` |
| Action | What it does | Slug |
| -------------------- | ---------------------------------------------------------- | ------------------------------ |
| Get me contact photo | Get the binary media content of a contact's profile photo. | `OUTLOOK_GET_ME_CONTACT_PHOTO` |
| Action | What it does | Slug |
| ------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| Get calendar permission | Retrieve a specific calendar permission for a user's calendar. | `OUTLOOK_GET_CALENDAR_PERMISSION` |
| Get calendar permission from calendar | Retrieve a specific calendar permission from a user's calendar. | `OUTLOOK_GET_CALENDAR_PERMISSION_FROM_CALENDAR` |
| Get user calendar allowed sharing roles | Retrieve allowed calendar sharing roles for a specific user on a given calendar. | `OUTLOOK_GET_USER_CALENDAR_ALLOWED_SHARING_ROLES` |
| Get user calendar group calendar permission | Retrieve a specific calendar permission for a user's calendar within a calendar group. | `OUTLOOK_GET_USER_CALENDAR_GROUP_CALENDAR_PERMISSION` |
| List calendar permissions | List calendar permissions for a specific calendar within a calendar group. | `OUTLOOK_LIST_CALENDAR_PERMISSIONS` |
| List event calendar permissions | List calendar permissions for the calendar containing a specific event. | `OUTLOOK_LIST_EVENT_CALENDAR_CALENDAR_PERMISSIONS` |
| List me calendar permissions | List calendar permissions for a specific user's calendar. | `OUTLOOK_LIST_ME_CALENDAR_PERMISSIONS` |
| List primary calendar permissions | List calendar permissions from a user's primary calendar. | `OUTLOOK_LIST_PRIMARY_CALENDAR_PERMISSIONS` |
| List user calendar permissions | List calendar permissions for a specific user's specific calendar. | `OUTLOOK_LIST_USER_CALENDARS_CALENDAR_PERMISSIONS` |
| Action | What it does | Slug |
| ------------------------------ | ----------------------------------------------------------- | ---------------------------------------- |
| Get mail folder message rule | Retrieve a specific message rule from a user's mail folder. | `OUTLOOK_GET_MAIL_FOLDER_MESSAGE_RULE` |
| List email rules | List all email rules from inbox. | `OUTLOOK_LIST_EMAIL_RULES` |
| List mail folder message rules | List message rules for a specific mail folder. | `OUTLOOK_LIST_MAIL_FOLDER_MESSAGE_RULES` |
| Action | What it does | Slug |
| --------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------- |
| Get calendar group schedule | Retrieve free/busy schedule information for a specific user's calendar within a calendar group. | `OUTLOOK_GET_CALENDAR_GROUP_SCHEDULE` |
| Get calendar schedule | Get free/busy schedule information for users, distribution lists, or resources. | `OUTLOOK_GET_CALENDAR_SCHEDULE` |
| Action | What it does | Slug |
| --------------------------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------- |
| List calendar view | DEPRECATED: Use OUTLOOK\_LIST\_ME\_CALENDARS\_CALENDAR\_VIEW instead. | `OUTLOOK_LIST_CALENDAR_CALENDAR_VIEW` |
| List user calendar groups calendar view | Get calendar view from a specific calendar within a calendar group for a user. | `OUTLOOK_LIST_USER_CALENDAR_GROUPS_CALENDAR_VIEW` |
| List user calendar view | Get calendar view from a specific user's calendar. | `OUTLOOK_LIST_USER_CALENDAR_VIEW` |
| Action | What it does | Slug |
| --------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------- |
| Get inference classification | Get inference classification settings for the authenticated user. | `OUTLOOK_GET_INFERENCE_CLASSIFICATION` |
| Get me Outlook | Retrieve the outlookUser object for a specified user. | `OUTLOOK_GET_ME_OUTLOOK` |
| Get supported time zones | Get the list of time zones supported for a user as configured on their mailbox server. | `OUTLOOK_GET_SUPPORTED_TIME_ZONES` |
| List inference classification overrides | List inference classification overrides that control Focused Inbox sender rules. | `OUTLOOK_LIST_INFERENCE_CLASSIFICATION_OVERRIDES` |
Agents can use 245 of the 306 Outlook actions at this level: everything in **Read-only**, plus:
* Search, create, update, and send emails
* Create and update extensions
* Search, create, update, and send events
* Create and update mail folders
* Create and send drafts
* Create attachments
* View, update, and manage reminders
* Create sessions
* Create and update contacts
* Create and update roles and permissions
* Create and update calendars
* Create and update rules
The 161 actions that this level adds to **Read-only**:
| Action | What it does | Slug |
| -------- | ------------ | ------------------ |
| Who am I | | `OUTLOOK_WHO_AM_I` |
| Action | What it does | Slug |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| Add event attachment | Adds an attachment to a specific Outlook calendar event. | `OUTLOOK_ADD_EVENT_ATTACHMENT` |
| Add mail attachment | Add an attachment to an email message. | `OUTLOOK_ADD_MAIL_ATTACHMENT` |
| Create calendar event attachment | Create a new attachment for an event in a specific calendar. | `OUTLOOK_CREATE_CALENDAR_EVENT_ATTACHMENT` |
| Create calendar group calendar event attachment | Create a new attachment for an event in a calendar within a calendar group for a specific user. | `OUTLOOK_CREATE_CALENDAR_GROUP_CALENDAR_EVENT_ATTACHMENT` |
| Create event attachment | Create a new attachment for a user's calendar event. | `OUTLOOK_CREATE_EVENT_ATTACHMENT` |
| Create mail folder message attachment | Add an attachment to a message in a specific mail folder. | `OUTLOOK_CREATE_MAIL_FOLDER_MESSAGE_ATTACHMENT` |
| Create message attachment | Create an attachment for a message. | `OUTLOOK_CREATE_MESSAGE_ATTACHMENT` |
| Create user calendar event attachment | Create a new attachment for an event in a specific user's calendar. | `OUTLOOK_CREATE_USER_CALENDAR_EVENT_ATTACHMENT` |
| Create user message attachment | Create an attachment on a message in a user's mail folder. | `OUTLOOK_CREATE_USER_MESSAGE_ATTACHMENT` |
| Download Outlook attachment | Downloads a specific file attachment from an email message in a Microsoft Outlook mailbox. | `OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT` |
| List Outlook attachments | Lists metadata (name, size, contentType, isInline. | `OUTLOOK_LIST_OUTLOOK_ATTACHMENTS` |
| Action | What it does | Slug |
| ----------------------------------- | ------------------------------------------------------------------- | --------------------------------------------- |
| Create calendar | Create a new calendar in the signed-in user's mailbox. | `OUTLOOK_CREATE_CALENDAR` |
| Create user calendar group calendar | Create a new calendar in a calendar group for a specific user. | `OUTLOOK_CREATE_USER_CALENDAR_GROUP_CALENDAR` |
| List calendars | List calendars in the signed-in user's mailbox. | `OUTLOOK_LIST_CALENDARS` |
| Update calendar groups calendars | Update a calendar within a calendar group in a user's mailbox. | `OUTLOOK_UPDATE_CALENDAR_GROUPS_CALENDARS` |
| Update user calendar | Update the properties of a user's calendar. | `OUTLOOK_UPDATE_USER_CALENDAR` |
| Update user calendars | Update properties of a specific calendar by ID for a specific user. | `OUTLOOK_UPDATE_USER_CALENDARS` |
| Action | What it does | Slug |
| --------------------------- | ------------------------------------------------------------------ | ------------------------------------- |
| Create master category | DEPRECATED: Use OUTLOOK\_CREATE\_USER\_MASTER\_CATEGORY instead. | `OUTLOOK_CREATE_MASTER_CATEGORY` |
| Create user master category | Create a new category in a user's master category list. | `OUTLOOK_CREATE_USER_MASTER_CATEGORY` |
| Get master categories | Retrieve the user's master category list. | `OUTLOOK_GET_MASTER_CATEGORIES` |
| Update master category | Update the color of a category in the user's master category list. | `OUTLOOK_UPDATE_MASTER_CATEGORY` |
| Action | What it does | Slug |
| -------------- | -------------------------------------------------------------- | ------------------------ |
| Get mail delta | Retrieve incremental changes (delta) of messages in a mailbox. | `OUTLOOK_GET_MAIL_DELTA` |
| Action | What it does | Slug |
| ---------- | ----------------- | -------------------- |
| List chats | List Teams chats. | `OUTLOOK_LIST_CHATS` |
| Action | What it does | Slug |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- |
| Create contact | Creates a new contact in a Microsoft Outlook user's contacts folder. | `OUTLOOK_CREATE_CONTACT` |
| Create me contact folders contacts | Create a new contact in a specific user's contact folder. | `OUTLOOK_CREATE_ME_CONTACT_FOLDERS_CONTACTS` |
| Create me contact in child folder | Create a new contact in a child folder within a contact folder. | `OUTLOOK_CREATE_ME_CONTACT_IN_CHILD_FOLDER` |
| Get me contacts | Retrieves a specific Outlook contact by its contact\_id from the contacts of a specified user\_id (defaults to 'me' for the authenticated user). | `OUTLOOK_GET_ME_CONTACTS` |
| List contacts | DEPRECATED: Use OUTLOOK\_LIST\_USER\_CONTACTS instead. | `OUTLOOK_LIST_CONTACTS` |
| Update child folder contact | Update a contact in a child contact folder within a parent contact folder. | `OUTLOOK_UPDATE_CHILD_FOLDER_CONTACT` |
| 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. | `OUTLOOK_UPDATE_CONTACT` |
| Update contact folders contacts | Update a contact within a specific contact folder. | `OUTLOOK_UPDATE_CONTACT_FOLDERS_CONTACTS` |
| Action | What it does | Slug |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| Create draft | Creates a new Outlook email draft with subject, body, recipients, and an optional attachment. | `OUTLOOK_CREATE_DRAFT` |
| Create forward draft | Create a forward draft of an Outlook message for a specific user. | `OUTLOOK_CREATE_FORWARD_DRAFT` |
| Create me forward draft | Create a draft forward of an existing message. | `OUTLOOK_CREATE_ME_FORWARD_DRAFT` |
| Create me mail folder message reply all draft | Deprecated: Use OUTLOOK\_CREATE\_REPLY\_ALL\_DRAFT instead, which supports both /me and /users/\{user\_id} endpoints with timezone support. | `OUTLOOK_CREATE_ME_MAIL_FOLDER_MESSAGE_REPLY_ALL_DRAFT` |
| Create me message reply all draft | Create a draft reply-all to a user's message. | `OUTLOOK_CREATE_ME_MESSAGE_REPLY_ALL_DRAFT` |
| Create me reply all draft | Create a draft reply-all to a message in a child folder. | `OUTLOOK_CREATE_ME_REPLY_ALL_DRAFT` |
| Create me reply draft | Deprecated: Use OUTLOOK\_CREATE\_DRAFT\_REPLY instead, which adds comment, cc\_emails, and bcc\_emails support. | `OUTLOOK_CREATE_ME_REPLY_DRAFT` |
| Create reply all draft | Create a reply-all draft for a message in a mail folder. | `OUTLOOK_CREATE_REPLY_ALL_DRAFT` |
| Create user mail folder message reply draft | Create a reply draft for a message in a user's mail folder. | `OUTLOOK_CREATE_USER_MAIL_FOLDER_MESSAGE_REPLY_DRAFT` |
| Send draft | Send an existing draft message. | `OUTLOOK_SEND_DRAFT` |
| Action | What it does | Slug |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| Batch move messages | Batch-move up to 20 Outlook messages to a destination folder in a single Microsoft Graph \$batch call. | `OUTLOOK_BATCH_MOVE_MESSAGES` |
| Batch update messages | Batch-update up to 20 Outlook messages per call using Microsoft Graph JSON batching. | `OUTLOOK_BATCH_UPDATE_MESSAGES` |
| Copy message | Copy an email message to another folder within the user's mailbox. | `OUTLOOK_COPY_MESSAGE` |
| Copy message from child folder | Copy an email message from a child folder (nested folder) to another folder within the user's mailbox. | `OUTLOOK_COPY_MESSAGE_FROM_CHILD_FOLDER` |
| Copy message from mail folder | Copy a message from a specific user's mail folder to another folder. | `OUTLOOK_COPY_MESSAGE_FROM_MAIL_FOLDER` |
| Create mail folder message | Create a new message in a specific mail folder. | `OUTLOOK_CREATE_MAIL_FOLDER_MESSAGE` |
| Create me child folder message | Create a new draft message in a child folder within a user's mail folder. | `OUTLOOK_CREATE_ME_CHILD_FOLDER_MESSAGE` |
| Create user message | Create a new draft message in a user's mailbox. | `OUTLOOK_CREATE_USER_MESSAGE` |
| Forward message | Forward a message. | `OUTLOOK_FORWARD_MESSAGE` |
| Get mail tips | Retrieve mail tips such as automatic replies and mailbox full status. | `OUTLOOK_GET_MAIL_TIPS` |
| Get message | Retrieves a specific email message by its ID from the specified user's Outlook mailbox. | `OUTLOOK_GET_MESSAGE` |
| List chat messages | List messages in a Teams chat. | `OUTLOOK_LIST_CHAT_MESSAGES` |
| List mail folder messages | List messages from a specific mail folder including subfolders. | `OUTLOOK_LIST_MAIL_FOLDER_MESSAGES` |
| 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. | `OUTLOOK_LIST_MESSAGES` |
| Move message from child folder | Move a message from a child folder to another destination folder. | `OUTLOOK_MOVE_MESSAGE_FROM_CHILD_FOLDER` |
| Move message from folder | Move a message from a specific mail folder to another destination folder. | `OUTLOOK_MOVE_MESSAGE_FROM_FOLDER` |
| Pin message | Pin a message in an Outlook chat. | `OUTLOOK_PIN_MESSAGE` |
| Query emails | Query Outlook emails within a SINGLE folder using OData filters. | `OUTLOOK_QUERY_EMAILS` |
| Reply email | Sends a reply to an Outlook email message with optional HTML formatting, identified by message\_id, allowing optional CC and BCC recipients. | `OUTLOOK_REPLY_EMAIL` |
| Search messages | Search Outlook messages using powerful KQL syntax. | `OUTLOOK_SEARCH_MESSAGES` |
| Send email | Sends an email with subject, body, recipients, and optional attachments via Microsoft Graph API. | `OUTLOOK_SEND_EMAIL` |
| Update email | Updates specified properties of an existing email message. | `OUTLOOK_UPDATE_EMAIL` |
| Update user child folder message | Update a message in a child folder within a user's mailbox. | `OUTLOOK_UPDATE_USER_CHILD_FOLDER_MESSAGE` |
| Update user mail folder message | Update properties of a message in a specific mail folder for a user. | `OUTLOOK_UPDATE_USER_MAIL_FOLDER_MESSAGE` |
| Action | What it does | Slug |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| Accept event | Accepts or tentatively accepts a calendar meeting invite on behalf of a user. | `OUTLOOK_ACCEPT_EVENT` |
| Calendar create event | Creates a new Outlook calendar event, ensuring start\_datetime is chronologically before end\_datetime. | `OUTLOOK_CALENDAR_CREATE_EVENT` |
| Create calendar event | DEPRECATED: Use OUTLOOK\_CREATE\_USER\_CALENDAR\_CALENDAR\_EVENT instead. | `OUTLOOK_CREATE_CALENDAR_EVENT` |
| Create calendar event in calendar | Create a new event in a specific calendar for a user. | `OUTLOOK_CREATE_CALENDAR_EVENT_IN_CALENDAR` |
| Create me event | Create a new calendar event for a specific user. | `OUTLOOK_CREATE_ME_EVENT` |
| Create user calendar group event | Create a new calendar event in a specific user's calendar within a calendar group. | `OUTLOOK_CREATE_USER_CALENDAR_GROUP_EVENT` |
| Decline event | Decline an invitation to a calendar event. | `OUTLOOK_DECLINE_EVENT` |
| Forward user calendar event | Forward a calendar event from a specific user's calendar to new recipients. | `OUTLOOK_FORWARD_USER_CALENDAR_EVENT` |
| Get event | Retrieves the full details of a specific calendar event by its ID from a user's Outlook calendar, provided the event exists. | `OUTLOOK_GET_EVENT` |
| Get user calendar event | Retrieve a specific calendar event from a user's primary calendar. | `OUTLOOK_GET_USER_CALENDAR_EVENT` |
| List events | Retrieves events from a user's Outlook calendar via Microsoft Graph API. | `OUTLOOK_LIST_EVENTS` |
| Search events | | `OUTLOOK_SEARCH_EVENTS` |
| Update calendar event | Updates specified fields of an existing Outlook calendar event. | `OUTLOOK_UPDATE_CALENDAR_EVENT` |
| Update calendar event in calendar | Update an event in a specific Outlook calendar. | `OUTLOOK_UPDATE_CALENDAR_EVENT_IN_CALENDAR` |
| Update calendar groups calendars events | Update an event in a calendar within a calendar group for a specific user. | `OUTLOOK_UPDATE_CALENDAR_GROUPS_CALENDARS_EVENTS` |
| 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). | `OUTLOOK_UPDATE_USER_CALENDAR_CALENDAR_EVENT` |
| Update user calendar event | Update an event in a specific user's calendar. | `OUTLOOK_UPDATE_USER_CALENDAR_EVENT` |
| Action | What it does | Slug |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| Create calendar group calendar event extension | Create a new open extension on a calendar event within a specific calendar group and calendar. | `OUTLOOK_CREATE_CALENDAR_GROUP_CALENDAR_EVENT_EXTENSION` |
| Create me calendar event extension | Create a new open extension on a calendar event for a specific user. | `OUTLOOK_CREATE_ME_CALENDAR_EVENT_EXTENSION` |
| Create me contact folders contacts extensions | Create a new open extension on a contact within a user's contact folder. | `OUTLOOK_CREATE_ME_CONTACT_FOLDERS_CONTACTS_EXTENSIONS` |
| Create me contact folders extensions | Create a new open extension on a contact within a child folder. | `OUTLOOK_CREATE_ME_CONTACT_FOLDERS_EXTENSIONS` |
| Create user contacts extensions | Create a new open extension on a specific user's contact. | `OUTLOOK_CREATE_USER_CONTACTS_EXTENSIONS` |
| Create user mail folder message extension | Create a new open extension on a message in a user's mail folder. | `OUTLOOK_CREATE_USER_MAIL_FOLDER_MESSAGE_EXTENSION` |
| Update event extension | Update an open extension on a calendar event in Microsoft Graph. | `OUTLOOK_UPDATE_EVENT_EXTENSION` |
| Update event extension in calendar group | Update an open extension on a calendar event within a calendar group. | `OUTLOOK_UPDATE_EVENT_EXTENSION_IN_CALENDAR_GROUP` |
| Update me contacts extensions | Update an open extension on a contact in a contact folder. | `OUTLOOK_UPDATE_ME_CONTACTS_EXTENSIONS` |
| Update user contact extension | Update an open extension on a contact in a user's contact folder. | `OUTLOOK_UPDATE_USER_CONTACT_EXTENSION` |
| Update user contacts extensions | Update an open extension on a contact in a user's contact folder. | `OUTLOOK_UPDATE_USER_CONTACTS_EXTENSIONS` |
| Update user contacts extensions direct | Update an open extension on a contact directly under a user's contacts collection. | `OUTLOOK_UPDATE_USER_CONTACTS_EXTENSIONS_DIRECT` |
| 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. | `OUTLOOK_UPDATE_USER_EVENT_EXTENSION` |
| Update user events extensions | Update an open extension on a user's calendar event. | `OUTLOOK_UPDATE_USER_EVENTS_EXTENSIONS` |
| Update user mail folder message extension | Update an open extension on a message within a specific user's mail folder. | `OUTLOOK_UPDATE_USER_MAIL_FOLDER_MESSAGE_EXTENSION` |
| Update user message extension | Update an open extension on a user's message. | `OUTLOOK_UPDATE_USER_MESSAGE_EXTENSION` |
| Action | What it does | Slug |
| ------------------------------------ | -------------------------------------------------------------------- | ---------------------------------------------- |
| Create cal group event attach upload | Create an upload session for large calendar group event attachments. | `OUTLOOK_CREATE_CAL_GROUP_EVENT_ATTACH_UPLOAD` |
| Action | What it does | Slug |
| --------------------- | ------------------------------------------------- | ------------------------------- |
| Create calendar group | Create a new calendar group for a user. | `OUTLOOK_CREATE_CALENDAR_GROUP` |
| Update calendar group | Update the properties of a calendar group object. | `OUTLOOK_UPDATE_CALENDAR_GROUP` |
| Action | What it does | Slug |
| ----------------------- | --------------------------------------------------- | --------------------------------- |
| Get supported languages | Retrieve supported languages in the user's mailbox. | `OUTLOOK_GET_SUPPORTED_LANGUAGES` |
| Action | What it does | Slug |
| ---------------- | ------------------------------------------------------- | -------------------------- |
| List to do lists | List Microsoft To Do task lists for the signed-in user. | `OUTLOOK_LIST_TO_DO_LISTS` |
| Action | What it does | Slug |
| -------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------ |
| Copy mail folder | Copy a user's mail folder and its contents to another folder. | `OUTLOOK_COPY_MAIL_FOLDER` |
| Copy me mail folder | Copy a child mail folder to a destination folder. | `OUTLOOK_COPY_ME_MAIL_FOLDER` |
| Create contact folder | Create a new contact folder in the user's mailbox. | `OUTLOOK_CREATE_CONTACT_FOLDER` |
| Create contact folder child folder | Create a child contact folder within a parent contact folder for a specific user. | `OUTLOOK_CREATE_CONTACT_FOLDER_CHILD_FOLDER` |
| Create mail folder | Create a new mail folder. | `OUTLOOK_CREATE_MAIL_FOLDER` |
| Create user mail folders child folders | Create a new child folder under a specified mail folder for a user. | `OUTLOOK_CREATE_USER_MAIL_FOLDERS_CHILD_FOLDERS` |
| List child mail folders | List subfolders (childFolders) under a specified Outlook mail folder. | `OUTLOOK_LIST_CHILD_MAIL_FOLDERS` |
| List mail folders | List a user's top-level mail folders. | `OUTLOOK_LIST_MAIL_FOLDERS` |
| Move mail folder | Move a mail folder and its contents to another mail folder. | `OUTLOOK_MOVE_MAIL_FOLDER` |
| Move me mail folder | Move a child mail folder to a different parent folder. | `OUTLOOK_MOVE_ME_MAIL_FOLDER` |
| Update contact folder | Update the properties of a contact folder for a specific user. | `OUTLOOK_UPDATE_CONTACT_FOLDER` |
| Update contact folder child folder | Update a child folder within a contact folder for a specific user. | `OUTLOOK_UPDATE_CONTACT_FOLDER_CHILD_FOLDER` |
| Update mail folder | Update the display name of a mail folder. | `OUTLOOK_UPDATE_MAIL_FOLDER` |
| Update user mail folders child folders | Update a child folder within a mail folder for a specific user. | `OUTLOOK_UPDATE_USER_MAIL_FOLDERS_CHILD_FOLDERS` |
| Action | What it does | Slug |
| ------------------ | ----------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| Find meeting times | Suggests meeting times based on organizer and attendee availability, time constraints, and duration requirements. | `OUTLOOK_FIND_MEETING_TIMES` |
| Action | What it does | Slug |
| ------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------- |
| Create user mail child folder msg ext | Create a new open extension on a message in a child mail folder for any user. | `OUTLOOK_CREATE_USER_MAIL_CHILD_FOLDER_MSG_EXT` |
| Action | What it does | Slug |
| ----------- | ------------------------------------------------------------- | --------------------- |
| Get profile | Retrieves the Microsoft Outlook profile for a specified user. | `OUTLOOK_GET_PROFILE` |
| Action | What it does | Slug |
| ------------------------------------ | ------------------------------------------------------------------------------------ | ---------------------------------------------- |
| Dismiss calendar event reminder | Dismiss a reminder for a specific event in a user's calendar. | `OUTLOOK_DISMISS_CALENDAR_EVENT_REMINDER` |
| Dismiss event reminder | Dismiss a reminder for a specific calendar event. | `OUTLOOK_DISMISS_EVENT_REMINDER` |
| Dismiss event reminder from group | Dismiss a reminder for an event in a user's calendar within a calendar group. | `OUTLOOK_DISMISS_EVENT_REMINDER_FROM_GROUP` |
| Dismiss user event reminder | Dismiss a reminder for a specific user's calendar event. | `OUTLOOK_DISMISS_USER_EVENT_REMINDER` |
| List reminders | Retrieve reminders for events occurring within a specified time range. | `OUTLOOK_LIST_REMINDERS` |
| Snooze calendar group event reminder | Snooze a reminder for a user's calendar event within a calendar group to a new time. | `OUTLOOK_SNOOZE_CALENDAR_GROUP_EVENT_REMINDER` |
| Snooze event reminder | Postpone an event reminder until a new time. | `OUTLOOK_SNOOZE_EVENT_REMINDER` |
| Snooze user calendar event reminder | Snooze a reminder for a calendar event in a specific user calendar to a new time. | `OUTLOOK_SNOOZE_USER_CALENDAR_EVENT_REMINDER` |
| Snooze user event reminder | Snooze a reminder for a user's calendar event to a new time. | `OUTLOOK_SNOOZE_USER_EVENT_REMINDER` |
| Action | What it does | Slug |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| Create 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. | `OUTLOOK_CREATE_DRAFT_REPLY` |
| Action | What it does | Slug |
| ----------------------------------------- | ------------------------------------------------------------------------- | --------------------------------------------------- |
| Create calendar permission | Create a calendar permission for a specific calendar in a calendar group. | `OUTLOOK_CREATE_CALENDAR_PERMISSION` |
| Create me calendar permission | Create a new calendar permission for a specific user's calendar. | `OUTLOOK_CREATE_ME_CALENDAR_PERMISSION` |
| Create user event calendar permission | Create a calendar permission via an event's calendar. | `OUTLOOK_CREATE_USER_EVENT_CALENDAR_PERMISSION` |
| Update calendar group calendar permission | Update a calendar permission within a calendar group. | `OUTLOOK_UPDATE_CALENDAR_GROUP_CALENDAR_PERMISSION` |
| Update calendar permission | Update calendar permission levels for share recipients or delegates. | `OUTLOOK_UPDATE_CALENDAR_PERMISSION` |
| Update user calendar permission | Update calendar permission levels for a specific user's calendar. | `OUTLOOK_UPDATE_USER_CALENDAR_PERMISSION` |
| Action | What it does | Slug |
| ------------------------------------ | ----------------------------------------------------- | ---------------------------------------------- |
| Create email rule | Create email rule filter with conditions and actions. | `OUTLOOK_CREATE_EMAIL_RULE` |
| Create mail folder message rule | Create a message rule in a user's mail folder. | `OUTLOOK_CREATE_MAIL_FOLDER_MESSAGE_RULE` |
| Update email rule | Update an existing email rule. | `OUTLOOK_UPDATE_EMAIL_RULE` |
| Update user mail folder message rule | Update a message rule in a user's mail folder. | `OUTLOOK_UPDATE_USER_MAIL_FOLDER_MESSAGE_RULE` |
| Action | What it does | Slug |
| ------------ | ---------------------------------------------------------------------------------------------------- | ---------------------- |
| Get schedule | Retrieves free/busy schedule information for specified email addresses within a defined time window. | `OUTLOOK_GET_SCHEDULE` |
| Action | What it does | Slug |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------- |
| Create attachment upload session | Create an upload session for large (>3 MB) message attachments. | `OUTLOOK_CREATE_ATTACHMENT_UPLOAD_SESSION` |
| Create attachment upload session in child folder | Create an upload session for large (>3 MB) message attachments in child mail folders. | `OUTLOOK_CREATE_ATTACHMENT_UPLOAD_SESSION_IN_CHILD_FOLDER` |
| Create calendar event attachment upload session | Create an upload session for large calendar event attachments in a specific calendar. | `OUTLOOK_CREATE_CALENDAR_EVENT_ATTACHMENT_UPLOAD_SESSION` |
| Create event attachment upload session | Create an upload session for large calendar event attachments. | `OUTLOOK_CREATE_EVENT_ATTACHMENT_UPLOAD_SESSION` |
| Create mail folder message attachment upload session | Create an upload session for large (>3 MB) message attachments in a specific mail folder. | `OUTLOOK_CREATE_MAIL_FOLDER_MESSAGE_ATTACHMENT_UPLOAD_SESSION` |
| Create me event attachment upload session | Create an upload session for large event attachments. | `OUTLOOK_CREATE_ME_EVENT_ATTACHMENT_UPLOAD_SESSION` |
| 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. | `OUTLOOK_CREATE_USER_EVENT_ATTACHMENT_UPLOAD_SESSION` |
| Action | What it does | Slug |
| ----------------------- | ----------------------------------------------- | --------------------------------- |
| Get mailbox settings | Retrieve mailbox settings. | `OUTLOOK_GET_MAILBOX_SETTINGS` |
| Update mailbox settings | Update mailbox settings for the signed-in user. | `OUTLOOK_UPDATE_MAILBOX_SETTINGS` |
| Action | What it does | Slug |
| ---------------- | ---------------------------------------------------------------------------------------- | -------------------------- |
| Create task | Create a new task in Microsoft To Do within a specified task list. | `OUTLOOK_CREATE_TASK` |
| List todo tasks | List tasks within a specified Microsoft To Do task list, including status and due dates. | `OUTLOOK_LIST_TODO_TASKS` |
| Update todo task | | `OUTLOOK_UPDATE_TODO_TASK` |
| Action | What it does | Slug |
| --------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| Get user by email | | `OUTLOOK_GET_USER_BY_EMAIL` |
| List users | List users in Microsoft Entra ID. | `OUTLOOK_LIST_USERS` |
| Update user inference classification override | Update the classification of messages from a specific sender in a user's Focused Inbox. | `OUTLOOK_UPDATE_USER_INFERENCE_CLASSIFICATION_OVERRIDE` |
| Action | What it does | Slug |
| ----------------- | ------------------------------------------------------------------- | --------------------------- |
| Get calendar view | Get events ACTIVE during a time window (includes multi-day events). | `OUTLOOK_GET_CALENDAR_VIEW` |
| Action | What it does | Slug |
| ------------------------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| Create me inference classification override | Create a Focused Inbox override for a sender identified by SMTP address for a specific user. | `OUTLOOK_CREATE_ME_INFERENCE_CLASSIFICATION_OVERRIDE` |
| List places | Retrieves a collection of place objects defined in a tenant by type. | `OUTLOOK_LIST_PLACES` |
| Update inference classification | Update the inferenceClassification resource for a user. | `OUTLOOK_UPDATE_INFERENCE_CLASSIFICATION` |
Agents can use 306 of the 306 Outlook actions at this level: everything in **Read + send**, plus:
* Delete attachments
* Delete extensions
* Delete and cancel events
* Delete contacts
* Delete emails
* Delete mail folders
* Delete roles and permissions
* Delete calendars
* Delete rules
* Delete categories
* Delete groups
* Delete tasks
The 61 actions that this level adds to **Read + send**:
| Action | What it does | Slug |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| Delete calendar event attachment | Delete user calendar event attachment. | `OUTLOOK_DELETE_CALENDAR_EVENT_ATTACHMENT` |
| Delete calendar group event attachment | Delete an attachment from an event in a calendar within a calendar group. | `OUTLOOK_DELETE_CALENDAR_GROUP_EVENT_ATTACHMENT` |
| Delete event attachment | Delete an attachment from an Outlook calendar event. | `OUTLOOK_DELETE_EVENT_ATTACHMENT` |
| Delete me events attachments | Delete an attachment from a user's Outlook event. | `OUTLOOK_DELETE_ME_EVENTS_ATTACHMENTS` |
| Delete me mail folders messages attachments | DEPRECATED: Use OUTLOOK\_DELETE\_MESSAGE\_ATTACHMENT instead. | `OUTLOOK_DELETE_ME_MAIL_FOLDERS_MESSAGES_ATTACHMENTS` |
| Delete me messages attachments | Delete an attachment from a message. | `OUTLOOK_DELETE_ME_MESSAGES_ATTACHMENTS` |
| Delete message attachment | Delete an attachment from a message in a nested mail folder structure. | `OUTLOOK_DELETE_MESSAGE_ATTACHMENT` |
| Delete user message attachment | Deprecated: Use OUTLOOK\_DELETE\_ME\_MESSAGES\_ATTACHMENTS instead, which supports both /me and /users/\{user\_id} endpoints. | `OUTLOOK_DELETE_USER_MESSAGE_ATTACHMENT` |
| Action | What it does | Slug |
| --------------------------- | ----------------------------------------------------------------------------- | ------------------------------------- |
| Delete calendar | Delete a calendar other than the default calendar from a user's mailbox. | `OUTLOOK_DELETE_CALENDAR` |
| Delete calendar from group | Delete a calendar from a specific user's calendar group in Microsoft Outlook. | `OUTLOOK_DELETE_CALENDAR_FROM_GROUP` |
| Delete calendar permanently | Permanently deletes a calendar from a user's mailbox. | `OUTLOOK_DELETE_CALENDAR_PERMANENTLY` |
| Action | What it does | Slug |
| ---------------------- | ------------------------------------------------------- | -------------------------------- |
| Delete master category | Delete a category from the user's master category list. | `OUTLOOK_DELETE_MASTER_CATEGORY` |
| Action | What it does | Slug |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| 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. | `OUTLOOK_DELETE_CONTACT` |
| Delete contact folder contact | Permanently delete a contact from a specific contact folder. | `OUTLOOK_DELETE_CONTACT_FOLDER_CONTACT` |
| Delete contact from child folder permanently | Permanently delete a contact from a child folder for a specific user. | `OUTLOOK_DELETE_CONTACT_FROM_CHILD_FOLDER_PERMANENTLY` |
| Delete contact from folder permanently | Permanently deletes a contact from a specific contact folder. | `OUTLOOK_DELETE_CONTACT_FROM_FOLDER_PERMANENTLY` |
| Delete contact permanently | Permanently deletes a contact. | `OUTLOOK_DELETE_CONTACT_PERMANENTLY` |
| Delete user child folder contact | Delete a contact from a child folder in a user's contact folder. | `OUTLOOK_DELETE_USER_CHILD_FOLDER_CONTACT` |
| Action | What it does | Slug |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| Delete child folder message | Delete a message from a child mail folder in Outlook. | `OUTLOOK_DELETE_CHILD_FOLDER_MESSAGE` |
| Delete mail folder message | Delete a message from a specific mail folder in Outlook. | `OUTLOOK_DELETE_MAIL_FOLDER_MESSAGE` |
| Delete me mail folders child folders messages extens | Delete user message extension. | `OUTLOOK_DELETE_ME_MAIL_FOLDERS_CHILD_FOLDERS_MESSAGES_EXTENS` |
| Delete message | Permanently delete an Outlook email message by its message\_id. | `OUTLOOK_DELETE_MESSAGE` |
| Delete message permanently from folder | DEPRECATED: Use OUTLOOK\_PERMANENT\_DELETE\_MESSAGE instead. | `OUTLOOK_DELETE_MESSAGE_PERMANENTLY_FROM_FOLDER` |
| Delete user child folder message permanently | Permanently delete a message from a user's child mail folder in Outlook. | `OUTLOOK_DELETE_USER_CHILD_FOLDER_MESSAGE_PERMANENTLY` |
| Move message | Move a message to another folder within the specified user's mailbox. | `OUTLOOK_MOVE_MESSAGE` |
| Permanent delete message | Permanently deletes an Outlook message by moving it to the Purges folder in the dumpster. | `OUTLOOK_PERMANENT_DELETE_MESSAGE` |
| Action | What it does | Slug |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ |
| Cancel calendar event | Cancel an event in a specific calendar for a specified user and send cancellation notifications to all attendees. | `OUTLOOK_CANCEL_CALENDAR_EVENT` |
| Cancel calendar group calendar event | Cancel an event in a user's calendar within a calendar group and send cancellation notifications to all attendees. | `OUTLOOK_CANCEL_CALENDAR_GROUP_CALENDAR_EVENT` |
| Cancel event | Cancel a calendar event for a specified user and send cancellation notifications to all attendees. | `OUTLOOK_CANCEL_EVENT` |
| Delete calendar event | Delete a calendar event from a user's Outlook calendar. | `OUTLOOK_DELETE_CALENDAR_EVENT` |
| Delete calendar event from specific calendar | Delete an event from a specific calendar in Outlook. | `OUTLOOK_DELETE_CALENDAR_EVENT_FROM_SPECIFIC_CALENDAR` |
| Delete calendar group calendar event | Delete a calendar event from a specific user's calendar within a calendar group. | `OUTLOOK_DELETE_CALENDAR_GROUP_CALENDAR_EVENT` |
| Delete calendar group event permanently | Permanently delete a calendar event from a calendar within a calendar group. | `OUTLOOK_DELETE_CALENDAR_GROUP_EVENT_PERMANENTLY` |
| Delete event | DEPRECATED: Use OUTLOOK\_DELETE\_CALENDAR\_EVENT instead. | `OUTLOOK_DELETE_EVENT` |
| Delete event permanently | Permanently deletes a calendar event. | `OUTLOOK_DELETE_EVENT_PERMANENTLY` |
| Delete user calendar event permanently | Permanently delete a calendar event from a specific user's calendar. | `OUTLOOK_DELETE_USER_CALENDAR_EVENT_PERMANENTLY` |
| Delete user event permanently | Permanently delete a calendar event for a specified user. | `OUTLOOK_DELETE_USER_EVENT_PERMANENTLY` |
| Action | What it does | Slug |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
| Delete contacts extensions | Delete a navigation property extension from a contact within a child folder. | `OUTLOOK_DELETE_CONTACTS_EXTENSIONS` |
| Delete event extension | Delete an open extension from a calendar event in a calendar group. | `OUTLOOK_DELETE_EVENT_EXTENSION` |
| Delete me contact extension | Delete an open extension from a contact. | `OUTLOOK_DELETE_ME_CONTACT_EXTENSION` |
| Delete me contact folder contact extension | Delete an extension from a contact in a user's contact folder. | `OUTLOOK_DELETE_ME_CONTACT_FOLDER_CONTACT_EXTENSION` |
| Delete me event extension | Delete an open extension from a user's calendar event. | `OUTLOOK_DELETE_ME_EVENT_EXTENSION` |
| Delete me mail folders messages extensions | Delete a navigation property extension from a message within a mail folder. | `OUTLOOK_DELETE_ME_MAIL_FOLDERS_MESSAGES_EXTENSIONS` |
| Delete message extension | Delete an open extension from an Outlook message. | `OUTLOOK_DELETE_MESSAGE_EXTENSION` |
| Delete user contact extension | Deprecated: Use OUTLOOK\_DELETE\_CONTACTS\_EXTENSIONS instead, which supports both /me and /users/\{user\_id} endpoints. | `OUTLOOK_DELETE_USER_CONTACT_EXTENSION` |
| Action | What it does | Slug |
| --------------------- | -------------------------------------------------------------- | ------------------------------- |
| Delete calendar group | Delete a calendar group other than the default calendar group. | `OUTLOOK_DELETE_CALENDAR_GROUP` |
| Action | What it does | Slug |
| ---------------------------------------------- | ------------------------------------------------------------------------------- | -------------------------------------------------------- |
| Delete child contact folder permanently | Permanently deletes a child contact folder. | `OUTLOOK_DELETE_CHILD_CONTACT_FOLDER_PERMANENTLY` |
| Delete contact folder | Delete a contact folder from the user's mailbox. | `OUTLOOK_DELETE_CONTACT_FOLDER` |
| Delete contact folder child folder | Delete a child contact folder from a parent contact folder for a specific user. | `OUTLOOK_DELETE_CONTACT_FOLDER_CHILD_FOLDER` |
| Delete contact folder permanently | Permanently deletes a contact folder. | `OUTLOOK_DELETE_CONTACT_FOLDER_PERMANENTLY` |
| Delete mail folder | Delete a mail folder from the user's mailbox. | `OUTLOOK_DELETE_MAIL_FOLDER` |
| Delete me mail folder child folder | Delete a child mail folder from a parent mail folder. | `OUTLOOK_DELETE_ME_MAIL_FOLDER_CHILD_FOLDER` |
| Delete me mail folder child folder permanently | Permanently deletes a child mail folder from a parent mail folder. | `OUTLOOK_DELETE_ME_MAIL_FOLDER_CHILD_FOLDER_PERMANENTLY` |
| Delete user mail folder permanently | Permanently deletes a mail folder for a specific user. | `OUTLOOK_DELETE_USER_MAIL_FOLDER_PERMANENTLY` |
| Action | What it does | Slug |
| ---------------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------- |
| Delete calendar permission | Delete a calendar permission from a user's calendar within a calendar group. | `OUTLOOK_DELETE_CALENDAR_PERMISSION` |
| Delete me calendar permission | Delete a calendar permission from a specific user's calendar. | `OUTLOOK_DELETE_ME_CALENDAR_PERMISSION` |
| Delete primary calendar permission | Delete a calendar permission from a specific user's calendar. | `OUTLOOK_DELETE_PRIMARY_CALENDAR_PERMISSION` |
| Action | What it does | Slug |
| ---------------------------------- | -------------------------------------------------- | -------------------------------------------- |
| Delete email rule | Delete an email rule permanently. | `OUTLOOK_DELETE_EMAIL_RULE` |
| Delete me mail folder message rule | Delete a message rule from a specific mail folder. | `OUTLOOK_DELETE_ME_MAIL_FOLDER_MESSAGE_RULE` |
| Action | What it does | Slug |
| ---------------- | ------------ | -------------------------- |
| Delete todo task | | `OUTLOOK_DELETE_TODO_TASK` |
| Action | What it does | Slug |
| ------------------------------------------- | ------------------------------------------------------------------ | ----------------------------------------------------- |
| Delete me inference classification override | Delete an inference classification override for a specific sender. | `OUTLOOK_DELETE_ME_INFERENCE_CLASSIFICATION_OVERRIDE` |
## Connect Outlook
Before you start:
* You need an Outlook account that you can sign in to.
* Your Squad subscription must be active. Squad does not connect apps while the subscription is not active.
Open **Settings** > **Integrations**.
On the **Connected apps** tab, click **+ Add integration**.
Find **Outlook** in the catalog and click it. You can type the name in **Search the catalog…**.
Under **Default scope**, choose an access level. This level applies to every agent.
Click **Connect Outlook**. The Outlook sign-in page opens in a new tab.
Sign in to Outlook and approve the request.
Check that it works: Outlook shows under **YOUR CONNECTIONS**, with a row for the account and its access level.
## Change the access level
1. Under **YOUR CONNECTIONS**, find the Outlook account.
2. Open the account menu (⋯) and click **Manage scope**.
3. Under **Default scope**, choose the new level.
4. Click **Save access**.
The change does not need a new sign-in. Agents get the new level from their next call.
## Set access for one agent
Every agent uses the account's level unless you set something else for it. You can narrow one agent to a lower level, or block it.
1. Under **YOUR CONNECTIONS**, open the account menu (⋯) on the Outlook account.
2. Click **Manage scope**.
3. Under **Per-agent access**, find the agent.
4. Choose the **Default** option to follow the account's level, choose a lower level, or choose **No access**.
5. Click **Save access**.
An agent never gets more than the account's level, even if you choose a higher level for it. Changes apply from the agent's next call. An agent with **No access** does not see the account.
## Use more than one Outlook account
Click **+ Account** on the Outlook card to connect another account. Agents use the primary account unless they are asked to use a specific one.
* After you click **+ Account**, follow the connect steps above.
* Each account has its own access level.
* The first account you connect becomes the primary account. It shows **★ PRIMARY**.
* To change the primary account, open the account menu (⋯) and click **Make primary**.
* To tell accounts apart, open the account menu (⋯) and click **Rename**.
## Reconnect or disconnect
Reconnect when the connection has expired, or when you need to change what the account can reach on the Outlook side:
1. Open the account menu (⋯) and click **Reconnect**.
2. Click **Reauthorize on Outlook**.
3. Sign in to Outlook and approve the request.
Reconnect signs in to the same account again. It does not add a second connection.
Open the account menu (⋯) on the Outlook account and click **Disconnect**. Agents lose access to that account at once.
**Disconnect** acts at once, with no confirmation step. If it was the primary account, another connected Outlook account becomes primary.
## Costs
Outlook actions do not use Squad credits. Connected apps never use credits. For what does use credits, see [What Squad costs](/docs/costs).
## Troubleshooting
An agent reports that an action is not allowed on this account.
* Cause: the action is outside the account's access level, or outside the level you set for that agent.
* Fix: choose a higher level in **Manage scope**, or change the agent's row under **Per-agent access**.
An agent says it has no access to Outlook, or it does not see the account.
* Cause: the agent is set to **No access** under **Per-agent access**, or the account is not connected.
* Fix: open **Manage scope** and change the agent's row. If the account is missing, connect it again.
Connecting or saving fails with "Your subscription isn't active."
* Cause: your Squad subscription is not active.
* Fix: resubscribe. See [Manage your subscription](/docs/billing).
An agent says the Outlook connection has expired.
* Cause: the sign-in for that account is no longer valid.
* Fix: use **Reconnect** on the account.
## Common questions
Each Outlook account has an access level: **Read-only**, **Read + send**, and **Full access**. Squad refuses any agent action outside that level. You can also narrow or block single agents under **Per-agent access**.
Click **+ Account** on the Outlook card to connect another account. Agents use the primary account unless they are asked to use a specific one.
Open the account menu (⋯) on the Outlook account and click **Disconnect**. Agents lose access to that account at once.
## Related pages
Use this when an action you need is not in this app.