# Create a Channel in Microsoft Teams

Automatically creates a brand-new channel inside a specified Microsoft Teams team as one dedicated step in an incident workflow.


> **Availability:** See the [Incident Workflow Actions Overview table](/workflow-actions) for the plans this workflow is available on.

## Description

Automatically create a [Microsoft Teams](/integrations/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](/ai-automation/automation/incident-workflows#create-an-incident-workflow).
2. When the instructions prompt you to [add actions](/ai-automation/automation/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](/ai-automation/automation/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](/ai-automation/automation/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.