Skip to content
API Reference

Outlook Email

Version: unreleased · Docs: 3c6ab9f2Download Markdown

Use Outlook Email to search a connected mailbox, inspect messages, save a draft, send a reviewed email, and organize selected messages.

Open Customize → Plugins and select this plugin. Add installs an available package; Uninstall means it is already installed. An offered Update refreshes its package version. Your deployment and administrator policy determine availability.

When Add Account is offered, follow its connection instructions using an authorized account that owns or can access the intended resource. If several accounts are connected, check the selected account and Default before the task. Reconnect refreshes an expired connection; an administrator setup notice needs administrator configuration.

Enable the plugin for the selected agent or task. On an installed plugin’s Tools table, check Enabled and the Approval setting for the operations you intend to use. New tasks use these settings; a pending approval still needs a decision. See agent setup and action approvals.

Use Outlook Email plugin in Redbelt

Plugin details under Customize → Plugins. The button shows the current installation state.

  1. Ask Redbelt to list mailbox folders and search for a project discussion using a topic you provide.
  2. Read the relevant message IDs. A batch read can inspect up to 20 selected messages at a time.
  3. Draft a milestone update using the deadlines stated in the messages and a request for owner confirmation.
  4. Check recipients, subject, and content before creating the Outlook draft.
  5. Review the saved draft. Sending is a separate action: specify the final recipients and request it explicitly.
  6. Inspect the returned result and locate the message in the mailbox.

Search my connected Outlook mailbox for the project topic I provide. Read the relevant messages and prepare a draft summarizing agreed milestones and asking the team to confirm missing owners. Use only dates stated in the messages. Do not send it yet.

Mailbox-wide listing, folder listing, listing messages inside a folder, and search have different scopes. Follow returned paging when you need a complete result set. A read retrieves a chosen message rather than searching for its title again.

Moving a message needs both its message ID and destination folder ID. Confirm that destination through folder discovery. Deleting is a separate operation and should target only the messages you selected. Check the returned result and provider folder rather than assuming a requested change succeeded.

Draft creation and sending are separate tools. A saved draft or accepted API request does not establish that the recipient received the message.

Thread and workflow availability are listed separately. A tool must also be enabled for your task and allowed by its account and administrator policy. Configure workflow app actions using only actions offered by the current picker.

Tool Required Fields Thread Workflow
microsoft_mail.create_draft to_recipients, subject, content Yes Yes
microsoft_mail.delete_message message_id Yes No
microsoft_mail.get_message message_id Yes No
microsoft_mail.list_folder_messages mail_folder_id Yes No
microsoft_mail.list_folders No mandatory top-level fields Yes No
microsoft_mail.list_messages No mandatory top-level fields Yes Yes
microsoft_mail.move_message message_id, destination_id Yes No
microsoft_mail.read_message_batch message_ids Yes No
microsoft_mail.search query_text Yes Yes
microsoft_mail.send to_recipients, subject, content Yes Yes

Required fields above are the schema minimum. The target, selected operation, or account can impose additional requirements.

microsoft_mail.create_draft — Create a draft email in Outlook. Optional fields: attachment_paths, attachment_upload_ids, bcc_recipients, cc_recipients, content_type.

microsoft_mail.delete_message — Delete an email message.

microsoft_mail.get_message — Get a specific email message by ID. Optional fields: select.

microsoft_mail.list_folder_messages — List messages in a specific mail folder. Optional fields: filter, orderby, search, select, top.

microsoft_mail.list_folders — List mail folders in the user’s mailbox. Optional fields: include_hidden.

microsoft_mail.list_messages — List messages in the signed-in user’s mailbox with optional search and filtering. Optional fields: is_read, query_text, relative_date_range, top.

microsoft_mail.move_message — Move a message to a different folder.

microsoft_mail.read_message_batch — Read full Outlook email content for up to 20 exact message IDs per call.

microsoft_mail.search — Search across Outlook emails. Optional fields: from_index, has_attachment, is_read, relative_date_range, sender, size, subject, to.

microsoft_mail.send — Send a new email via Outlook. Optional fields: attachment_paths, attachment_upload_ids, bcc_recipients, cc_recipients, content_type, save_to_sent_items.

Check the connected Microsoft account and mailbox if folders or messages are missing. For an interrupted send, inspect the sent items before retrying.

Provider details: Outlook documentation.