> ## 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 Webhook Setup Guide

> Configure Microsoft Outlook to deliver events to StackOne.

## Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See [Getting Started](/connectors/microsoftoutlook#getting-started) on the Microsoft Outlook connector page.

<section data-guide-section data-guide-scopes="">
  <h2>How StackOne sets up Microsoft Outlook webhooks</h2>

  <p>Nothing needs configuring in Outlook or Azure. When you connect an account with events enabled, StackOne creates a Microsoft Graph change-notification subscription automatically and deletes it again when the connection is removed. A single subscription carries every event you enable.</p>

  <Steps>
    <Step title="Check that the mail permission is granted">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>A message subscription needs read access to mail — <strong>Mail.ReadBasic</strong> is enough, and <strong>Mail.Read</strong> or <strong>Mail.ReadWrite</strong> satisfies it too. No webhook-specific permission has to be added.</p>

        <ul>
          <li>If the connection can list messages today, it can receive mail webhooks.</li>
          <li>Microsoft Graph rejects write-only access — a read permission is required even though the subscription only reads data.</li>
        </ul>
      </div>
    </Step>

    <Step title="Check which mailbox is covered">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The subscription is created against the mailbox of the user who authorised the connection, so it reports changes to that user's messages only. To follow another user's mail, connect an account authorised by that user.</p>

        <ul>
          <li>The whole mailbox is covered, not just the Inbox — drafts, Sent Items and folder moves all raise events.</li>
        </ul>
      </div>
    </Step>

    <Step title="Connect the account again when the subscription expires">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Microsoft Graph expires mail subscriptions after at most seven days, and StackOne does not renew them. Delivery stops silently when the subscription lapses — no error is raised, events simply stop arriving.</p>

        <ul>
          <li>Reconnect the account to create a fresh subscription and resume delivery.</li>
          <li>Reconnecting also removes the previous subscription, so no duplicates are left behind.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Available webhook events</h2>

  <p>Microsoft Outlook emits three event types, covering the lifecycle of a message in the connected user's mailbox. Only events selected in StackOne are dispatched to your application.</p>

  <Steps>
    <Step title="Enable message events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events covering messages anywhere in the connected user's mailbox. Because the whole mailbox is covered, mail the user sends or drafts raises the same events as mail they receive from others.</p>

        <ul>
          <li><strong>Message Created</strong> (`message_created`) — Fired when a message is added to the mailbox: mail received, a draft saved, or a sent message filed into Sent Items.</li>
          <li><strong>Message Updated</strong> (`message_updated`) — Fired when a message changes, including marking it read or unread, changing a flag or category, editing a draft, or moving it between folders.</li>
          <li><strong>Message Deleted</strong> (`message_deleted`) — Fired when a message is removed from the mailbox.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.


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