> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Outlook

> Manage email, calendars, contacts, and tasks via your connected account.

Use Outlook when your workflow needs email, calendar, contacts, or tasks in one place. You can read, create, update, and organize items with connected account actions.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Outlook account to use for this step. |
| Action | Yes | The Outlook action to perform (for example List messages, Get message, Send email, Reply to email). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Outlook in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **List messages** | List email messages from a folder or across the mailbox. |
| **Get message** | Retrieve the full details of an email message. |
| **Send email** | Send a new email message to one or more recipients. |
| **Reply to email** | Reply to an email message with a comment. |
| **Forward message** | Forward an email message to other recipients. |
| **Move message** | Move an email message to another folder. |
| **Create mail folder** | Create a new mail folder in the mailbox. |
| **List mail folders** | List the top-level mail folders in the mailbox. |
| **List events** | List calendar events in the signed-in user's calendar. |
| **Get calendar view** | Get events that are active during a time window. |
| **Create event** | Create a new calendar event for the signed-in user. |
| **Get event** | Retrieve the full details of a calendar event. |
| **Accept event invite** | Accept or tentatively accept a calendar meeting invite. |
| **Decline event invite** | Decline a calendar meeting invite. |
| **Create contact** | Create a new contact in the user's contacts folder. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Outlook response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Outlook if you have not already done that.
2. Add an **Outlook** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **List messages** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Follow up on a lead email

1. List messages
2. Get message
3. Reply to email

### Schedule a meeting

1. Search people
2. Create event
3. Accept event invite

### Organize incoming mail

1. List mail folders
2. Move message
3. Create mail folder

## Notes

* This step depends on a connected Outlook integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Outlook tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Outlook as an Agent Tool

You can also add Outlook as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Outlook**. In the tool settings panel, choose the connected account the agent should use. The agent calls Outlook actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.