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

# Microsoft Teams

> Microsoft Teams helps people chat, meet, and collaborate in channels, chats, meetings, and schedules via your connected account.

Use Microsoft Teams when your workflow needs team chat, channel messaging, meetings, or schedule actions. It is also useful when you need to read or update team and channel records.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Microsoft Teams account to use for this step. |
| Action | Yes | The Microsoft Teams action to perform (for example Get user profile, List teams, Get team by ID, List team channels). |
| 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 Microsoft Teams 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 |
| - | - |
| **Get user profile** | Retrieve the connected user's profile details. |
| **List teams** | List the teams available to the connected user. |
| **Get team by ID** | Retrieve a team with its properties by ID. |
| **List team channels** | List the channels in a team. |
| **Create a channel** | Create a new channel in a team. |
| **Get team channel** | Retrieve a specific channel in a team. |
| **List channel messages** | List messages in a team channel. |
| **Send channel message** | Post a new message to a channel. |
| **Update channel message** | Update an existing message in a channel. |
| **Reply to channel message** | Reply to an existing channel message. |
| **Create online meeting** | Schedule a standalone online meeting. |
| **Get online meeting** | Retrieve details for an online meeting. |
| **Update online meeting** | Update an existing online meeting. |

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

## Output

This step stores the Microsoft Teams 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 Microsoft Teams if you have not already done that.
2. Add a **Microsoft Teams** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Get user profile** 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

### Post a channel update

1. List team channels
2. Send channel message
3. Reply to channel message

### Manage a meeting

1. Create online meeting
2. Get online meeting
3. Update online meeting

### Handle schedule changes

1. List shifts
2. Create team schedule shift
3. Update team schedule shift

## Notes

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

## Using Microsoft Teams as an Agent Tool

You can also add Microsoft Teams as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Microsoft Teams**. In the tool settings panel, choose the connected account the agent should use. The agent calls Microsoft Teams 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.