> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Outlook

> How to set up the Microsoft Outlook connector, plus the actions and events that are available.

![Microsoft Outlook](https://stackone-logos.com/api/outlook/filled/svg)

v5.0.0[See changelog](https://docs.stackone.com/connectors/microsoftoutlook/changelog.md)

[39 actions](#actions) · [5 events](#events) · 2 auth methods

Messaging

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/microsoftoutlook/guides/connector-profile/oauth-2-0.md)
>
> Delegated access on behalf of a signed-in user. Requires an app registration in Microsoft Entra ID with Mail API permiss...

> [card] [OAuth 2.0 (Client Credentials) · Connector Profile](https://docs.stackone.com/connectors/microsoftoutlook/guides/connector-profile/oauth-2-0-client-credentials.md)
>
> App-only access without a signed-in user, covering every mailbox in the tenant unless an Exchange admin restricts it. Ev...

Optionally, configure receiving Events for Microsoft Outlook into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/microsoftoutlook/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/microsoftoutlook/guides/link-account/oauth-2-0.md)

> [card] [OAuth 2.0 (Client Credentials) · Link Account](https://docs.stackone.com/connectors/microsoftoutlook/guides/link-account/oauth-2-0-client-credentials.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Scopes

Select all
|
Clear

Mail.Read

Mail.ReadBasic

Mail.ReadWrite

Mail.Send

MailboxSettings.Read

MailboxSettings.ReadWrite

No scopes found

39 actions

ActionDescriptionRequired scopes

List Messages`microsoftoutlook_list_messages`

Get all messages in the signed-in user's mailbox or in a specific folder

`Mail.ReadBasic`

Get Message Delta From Folder`microsoftoutlook_get_set_of_messages_from_specified_folder`

Get a set of messages added, deleted, or updated in a specified folder

`Mail.ReadBasic`

Get Message`microsoftoutlook_get_message`

Read properties and relationships of a specific message

`Mail.ReadBasic`

Create Draft Message`microsoftoutlook_create_draft_message`

Create a draft of a new message in JSON format

`Mail.ReadWrite`

Update Message`microsoftoutlook_update_message`

Update the properties of a message object

`Mail.ReadWrite`

Delete Message`microsoftoutlook_delete_message`

Delete a message in the user's mailbox

`Mail.ReadWrite`

Send Mail`microsoftoutlook_send_mail`

Send a new email message using JSON or MIME format

`Mail.Send`

Send Draft Message`microsoftoutlook_send_draft`

Send a previously created draft message

`Mail.Send`

Forward Message`microsoftoutlook_forward_message`

Forward a message to specified recipients

`Mail.Send`

Reply To Message`microsoftoutlook_reply_message`

Reply to the sender of a message

`Mail.Send`

Reply All To Message`microsoftoutlook_reply_all_message`

Reply to all recipients of a message

`Mail.Send`

Create Draft Reply To Message`microsoftoutlook_create_draft_reply_to_message`

Create a draft to reply to the sender of a message

`Mail.ReadWrite`

Create Draft Reply All To Message`microsoftoutlook_create_draft_reply_all_to_message`

Create a draft to reply to the sender and all recipients of a message

`Mail.ReadWrite`

Copy Message`microsoftoutlook_copy_message`

Copy a message to a destination folder

`Mail.ReadWrite`

Move Message`microsoftoutlook_move_message`

Move a message to a destination folder

`Mail.ReadWrite`

Permanently Delete Message`microsoftoutlook_permanently_delete_message`

Permanently delete a message and place it in the purges folder

`Mail.ReadWrite`

Create Draft To Forward Message`microsoftoutlook_create_draft_to_forward_message`

Create a draft to forward an existing message

`Mail.ReadWrite`

List Attachments`microsoftoutlook_list_attachments`

Retrieve a list of attachments attached to a message

`Mail.Read`

Get Attachment`microsoftoutlook_get_attachment`

Get the properties and relationships of an attachment

`Mail.Read`

Add Attachment`microsoftoutlook_add_attachment`

Add a file, item, or link attachment to a message

`Mail.ReadWrite`

Delete Attachment`microsoftoutlook_delete_attachment`

Delete an attachment from a message

`Mail.ReadWrite`

Get Mail Folder Delta`microsoftoutlook_get_mail_folder_delta`

Get incremental changes to mail folders in the mailbox

`Mail.ReadBasic`

List Mail Folders`microsoftoutlook_list_mail_folders`

Get the mail folder collection under the root folder

`Mail.ReadBasic`

Get Mail Folder`microsoftoutlook_get_mail_folder`

Retrieve properties and relationships of a mail folder

`Mail.ReadBasic`

Create Mail Folder`microsoftoutlook_create_mail_folder`

Create a new mail folder in the root folder

`Mail.ReadWrite`

Update Mail Folder`microsoftoutlook_update_mail_folder`

Update the writable properties of a mailFolder object

`Mail.ReadWrite`

Delete Mail Folder`microsoftoutlook_delete_mail_folder`

Delete a mail folder

`Mail.ReadWrite`

Permanently Delete Mail Folder`microsoftoutlook_permanently_delete_mail_folder`

Permanently delete a mail folder and remove its items from the mailbox

`Mail.ReadWrite`

Copy Mail Folder`microsoftoutlook_copy_mail_folder`

Copy a mailFolder and its contents to another mailFolder

`Mail.ReadWrite`

Move Mail Folder`microsoftoutlook_move_mail_folder`

Move a mailFolder and its contents to another mailFolder

`Mail.ReadWrite`

List Child Folders`microsoftoutlook_list_child_folders`

Get the folder collection under the specified folder

`Mail.ReadBasic`

Create Child Folder`microsoftoutlook_create_child_folder`

Create a new child mail folder under a specified folder

`Mail.ReadWrite`

Create Message In Mail Folder`microsoftoutlook_create_message_in_mail_folder`

Create a new draft message in a specified mail folder

`Mail.ReadWrite`

List Folder Messages`microsoftoutlook_list_folder_messages`

Get all messages in a specified folder

`Mail.ReadBasic`

List Message Rules`microsoftoutlook_list_message_rules`

Get all message rules defined for the user's inbox

`MailboxSettings.Read`

Get Message Rule`microsoftoutlook_get_message_rule`

Read properties and relationships of a message rule

`MailboxSettings.Read`

Create Message Rule`microsoftoutlook_create_message_rule`

Create a message rule with conditions and actions

`MailboxSettings.ReadWrite`

Update Message Rule`microsoftoutlook_update_message_rule`

Change writable properties of a message rule

`MailboxSettings.ReadWrite`

Delete Message Rule`microsoftoutlook_delete_message_rule`

Delete a message rule

`MailboxSettings.ReadWrite`

## Events

Tags

Select all
|
Clear

Messages

Webhooks

No tags found

5 events

EventDescriptionTags

Validation Check`microsoftoutlook_webhook_validation_check`

Confirms to Microsoft that StackOne is reachable when the connection is made.

Webhooks

Subscription Lifecycle Notification`microsoftoutlook_webhook_lifecycle_notification`

Acknowledges Microsoft Graph subscription lifecycle notifications.

Webhooks

Message Created`microsoftoutlook_webhook_message_created`

Fired when a message is added to the user's mailbox.

MessagesWebhooks

Message Updated`microsoftoutlook_webhook_message_updated`

Fired when a message in the user's mailbox changes.

MessagesWebhooks

Message Deleted`microsoftoutlook_webhook_message_deleted`

Fired when a message is removed from the user's mailbox.

MessagesWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.