Docs / Workflows / Integrations / Outlook Mail
Outlook Mail
Read, organise, draft and send mail from a connected Outlook mailbox.
What you can do
Each Outlook Mail integration’s page in OAIZ shows these uses, with its events and its read and write actions, under What you can do with Outlook Mail.
- Reply drafts
- Draft a reply to each customer email for someone to check and send.
- Invoice filing
- Move invoices to a folder and pass their details on.
- Key customers
- Flag emails from key customers so nobody misses them.
Connection scope
The connection reads the connected user’s primary mailbox through its Microsoft account. Message IDs come from Outlook actions and use Microsoft’s immutable ID format. Folder IDs identify mailbox locations. Drafts are separate from sent mail.
Connecting
Choose Outlook Mail in OAIZ and authorize the Microsoft account the workflows should use. If this service is being added to an existing Microsoft connection, use the same account.
This service requests Mail.Read, Mail.ReadWrite, Mail.Send and MailboxSettings.ReadWrite to read and manage the connected mailbox, send messages and manage category colours. Every Microsoft connection also requests openid, profile, email, offline_access and User.Read for account identity and renewal. Enabling another Microsoft service adds that service’s permissions to the shared connection.
Read actions
- List Folders
- List mailbox folders.
- List Emails
- Read message summaries from a folder, with pagination. Results include a body preview.
- Search Emails
- Search the connected mailbox using a Microsoft Graph message-search expression. Results contain message summaries.
- Get Email
- Read a message’s metadata and body in text or filtered HTML.
- List Email Attachments
- Read attachment metadata, including inline files, embedded items and reference links.
- Get Email Attachment
- Download a supported file attachment into OAIZ.
- Get Draft
- Read an unsent draft’s editable fields and attachment metadata.
Write actions
- Create Draft
- Create an unsent message, optionally with small file attachments.
- Update Draft
- Change an unsent draft’s fields or attachments. Omitted fields stay unchanged.
- Send Draft
- Send an existing draft. The result reports whether Microsoft accepted it for delivery.
- Send Email
- Create and send a message in one call. If sending fails after saving, the result can identify the remaining draft.
- Create Reply Draft
- Create an unsent reply quoting the original message and addressed to its sender or reply-to address.
- Create Reply-All Draft
- Create an unsent reply quoting the original message and addressed to its sender and other recipients.
- Create Forward Draft
- Create an unsent forward quoting the original message for supplied recipients.
- Set Email Read State
- Mark a message read or unread.
- Add Email Categories
- Add category names to a message while preserving its other categories.
- Remove Email Categories
- Remove selected category names from a message.
- Set Email Flag
- Set or clear a message’s follow-up flag, with optional start and due dates.
- Move Email
- Move a message to a folder and return its resulting message ID and folder ID.
- Delete Email
- Delete a message using the mailbox’s ordinary deletion behaviour.
- Set Category Color
- Create a named category with a colour or change the existing category’s colour.
Events
Mailbox events describe received email, sent email, draft creation and messages moved, archived or deleted from the Inbox. They contain bounded summaries without bodies or attachments. Sent and draft events observe the corresponding mailbox folders.
Write behaviour
An outcome_unknown result means OAIZ does not confirm whether Microsoft applied the write. Read the message or mailbox before repeating that action. Sending a message twice can produce two emails.