---
updatedAt: 2026-04-21T15:27:13.000Z
agentTools:
  siteIndex: https://support.pagerduty.com/llms.txt
  projectIndex: https://support.pagerduty.com/actions/llms.txt
---

# Create a Channel in Microsoft Teams

Microsoft Teams

> 📘 Availability
>
> This workflow action is available on Business and Enterprise for Incident Management pricing plans. Contact the [Sales Team](https://www.pagerduty.com/contact-us/#contact-sales) to upgrade to an account with this action.

# Description

Automatically create a [Microsoft Teams](https://support.pagerduty.com/main/docs/microsoft-teams) channel within a specified team as part of an incident workflow.

# Instructions

1. If you have not done so, follow the instructions to [Create an Incident Workflow](/main/docs/incident-workflows#create-an-incident-workflow).
2. When the instructions prompt you to [add actions](/main/docs/incident-workflows#add-actions), select **this action**.
3. Enter the following **Inputs** and click **Save**.
4. Continue following instructions to **Publish** the Workflow.
5. When the action runs, you will see the **Outputs** listed below.

# Inputs

> 📘 Field References
>
> Fields with the **{+}** icon accept [Field References](https://support.pagerduty.com/main/docs/incident-workflows#field-references), which can be useful for referencing incident data or outputs created in prior workflow steps. To add Field References, click **{+}**, or enter `{{`, and select relevant fields. Refer to the [Field References](https://support.pagerduty.com/main/docs/incident-workflows#field-references) article for more information.

<br />

| Name                                 | Description                                                              |
| :----------------------------------- | :----------------------------------------------------------------------- |
| **Microsoft Teams Organization**     | Select the name of the Microsoft Teams Organization the meeting is in.   |
| **Microsoft Teams Team**             | The Microsoft Teams Team ID under which the new channel will be created. |
| **Channel Name**                     | The name for the new channel. Maximum 50 characters.                     |
| **Channel Description** (*optional*) | A description providing context about the channel's purpose.             |

# Outputs

| Name               | Description                                                                                         |
| :----------------- | :-------------------------------------------------------------------------------------------------- |
| **Channel Name**   | The name of the newly created Microsoft Teams channel.                                              |
| **Channel URL**    | The web URL to the newly created channel.                                                           |
| **Result**         | Value that shows if the action was successful or not. Either `Success` or `Failed`.                 |
| **Result Summary** | Brief description of what the action did, or a summary of the failure reason if it did not succeed. |
| **Error**          | Description of the error, populated only if the action failed.                                      |
| **Team ID**        | The internal ID of the Microsoft Teams team where the channel was created.                          |
| **Channel ID**     | The internal ID of the newly created Microsoft Teams channel.                                       |

# Examples

**Example 1: Create a dedicated incident channel automatically**

When a high-severity incident is triggered, use this action to create a new channel named after the incident (e.g., `incident-2026-04-17-payment-outage`) in your `SRE Team`. Follow it with a notification step that includes the **Channel URL** so all responders can join immediately without manual coordination.