Search documentation

Search for a topic, a control, or an event type.

    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.