Skip to main content

Microsoft 365 Outlook — Application Overview

Overview​

Microsoft 365 Outlook is the email and messaging service in the Microsoft 365 ecosystem. Organizations use it to send and receive email, manage drafts, work with attachments, and organize mailbox content.

The Microsoft 365 Outlook integration within the Wrk platform lets you automate mailbox workflows by calling the Microsoft Graph Mail API through prebuilt Wrk Actions.

This document provides an overview of how Outlook integrates into Wrk, how authentication works, general API behaviour, and a list of available Wrk Actions.

Authentication​

Microsoft 365 Outlook uses OAuth 2.0 authentication for secure access.

  1. Create a new Microsoft 365 Outlook Connected Account in Wrk.
  2. Sign in using your Microsoft 365 account.
  3. Review and approve the requested permissions.
  4. Complete the authorization flow so Wrk can access the mailbox.

Important Notes​

  • Access tokens expire automatically and are refreshed by Wrk in the background.
  • Revoking permissions in Microsoft Entra ID or Microsoft 365 requires the account to be reauthenticated.
  • Organization-level conditional access policies may block authentication depending on tenant configuration.

General API Behaviour​

Microsoft Graph Mail API​

The Outlook integration uses the Microsoft Graph REST API for mail.

Most message operations work with message resources that commonly include:

  • id — unique message identifier
  • subject — email subject
  • body — message content
  • from / toRecipients — participants
  • receivedDateTime / sentDateTime — timestamps
  • hasAttachments — whether attachments are present

Pagination​

Large collection responses (for example listing messages) are paginated.

Microsoft Graph returns an @odata.nextLink property when additional pages are available. Use that link for the next request rather than inventing your own pagination parameters.

Query parameters​

Microsoft Graph supports OData query parameters such as:

  • $select — return only specified fields
  • $filter — filter returned records
  • $top — limit number of returned records
  • $orderby — sort results

Available Wrk Actions​

  • Add attachment
  • Create email draft
  • Create reply draft
  • Delete message
  • Forward email
  • Move message
  • Perform an API call
  • Reply to email
  • Retrieve attachment
  • Retrieve attachments
  • Retrieve message
  • Retrieve messages
  • Send draft message
  • Send email

Additional Resources​