Overview
Microsoft 365 Outlook is a cloud-based email and calendar platform used by businesses and organizations to manage communication, scheduling, contacts, and collaboration workflows. The Microsoft 365 Outlook integration within the Wrk platform allows you to automate email, calendar, and mailbox-management workflows by calling the Microsoft Graph API through prebuilt Wrk Actions.
This document provides an overview of how Microsoft 365 Outlook integrates into Wrk, how authentication works, general API behaviour, and a full list of available Wrk Actions.
Authentication
Microsoft 365 Outlook uses OAuth 2.0 authentication for secure access.
Create a new Microsoft 365 Outlook Connected Account in Wrk.
Sign in with your Microsoft 365 account.
Review and approve the requested Microsoft Graph permissions.
Complete the authorization flow to allow Wrk access to Outlook resources.
General API Behaviour
Microsoft Graph API Structure
The integration uses the Microsoft Graph REST API for Outlook resources. Most Outlook entities follow a consistent JSON structure and include fields such as:
id — unique entity identifier
createdDateTime — creation timestamp
lastModifiedDateTime — update timestamp
changeKey — version identifier used for concurrency tracking
Pagination
Microsoft Graph paginates large collections automatically.
Paginated responses typically include an:
@odata.nextLink
value that contains the URL for retrieving the next page of results.
Example:
GET /me/messages?$top=50
Important notes:
Many Outlook endpoints default to server-side pagination.
Maximum page sizes vary by endpoint.
The @odata.nextLink URL should be treated as opaque and reused exactly as returned.
Clients should continue paging until @odata.nextLink is no longer present.
Filtering and Querying
Microsoft Graph supports OData query parameters for filtering, sorting, and field selection.
Common query parameters include:
$filter
$select
$orderby
$top
Example:
GET /me/messages?$filter=isRead eq false&$orderby=receivedDateTime DESC
Important notes:
Filtering syntax follows OData conventions.
Some complex filters require additional indexing support from Microsoft Graph.
Unsupported combinations of filters and sorting may return errors.
Time Zones and Date Handling
Outlook calendar APIs use ISO 8601 date formats and support explicit timezone handling.
When creating or retrieving events, timezone values should be handled carefully to avoid scheduling inconsistencies across regions.
Available Wrk Actions for Microsoft 365 Outlook
Delete message in Microsoft 365 Outlook
Forward email in Microsoft 365 Outlook
Move message in Microsoft 365 Outlook
Reply to email in Microsoft 365 Outlook
Retrieve attachment from Microsoft 365 Outlook
Retrieve attachments from Microsoft 365 Outlook
Retrieve message from Microsoft 365 Outlook
Retrieve messages from Microsoft 365 Outlook
Send draft message in Microsoft 365 Outlook
Send email in Microsoft 365 Outlook
Additional Resources
Microsoft Graph Outlook API Reference:
https://learn.microsoft.com/en-us/graph/api/resources/mail-api-overview
Microsoft Graph Authentication Documentation:
https://learn.microsoft.com/en-us/graph/auth/
Microsoft Graph Permissions Reference:
https://learn.microsoft.com/en-us/graph/permissions-reference
Microsoft Graph Query Parameters:
https://learn.microsoft.com/en-us/graph/query-parameters
Microsoft Graph Paging Documentation:
https://learn.microsoft.com/en-us/graph/paging
Microsoft Graph Throttling Guidance:
https://learn.microsoft.com/en-us/graph/throttling
Microsoft Graph Delta Query Documentation:
https://learn.microsoft.com/en-us/graph/delta-query-overview