# Outlook Email

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

## Before you start

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](/agents/create/) and [action approvals](/threads/approvals/).

![Use Outlook Email plugin in Redbelt](/screenshots/current/plugin-microsoft-mail.png)

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

## Prepare a project email

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.

## Organize selected messages

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.

## Tool Reference

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](/workflows/apps/) using only actions offered by the current picker.

### Available Tools

| 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`.

## Troubleshoot

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](https://support.microsoft.com/en-us/outlook/).
