# Link Incident Notification Channel in Microsoft Teams

Links an already-existing Microsoft Teams channel to an incident so that all future notifications post directly there instead.


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

## Description

Link a specified [Microsoft Teams](/integrations/microsoft-teams) channel to an incident.

## 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** | Name of the Microsoft Teams Organization the channel is in. Example: `PagerDuty`.                                        |
| **Microsoft Teams Team**         | Name of the Microsoft Teams Team the channel belongs to. Example: `SRE Team`.                                            |
| **Microsoft Teams Team Channel** | Name of the channel inside the specified Team to link to the incident. Examples: `general`, `incidents`, `sre-war-room`. |

## 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.                                      |
| **MS Teams Team ID**    | The internal ID of the Microsoft Teams team associated with the linked channel.                     |
| **MS Teams Channel ID** | The internal ID of the linked Microsoft Teams channel.                                              |

## Examples

**Example 1: Automatically link a war room channel during a major incident**

When a high-severity incident is triggered, use this action to automatically link your `sre-war-room` channel in the `SRE Team` within your `PagerDuty` Microsoft Teams organization. Pair this with a notification action that sends the **Channel URL** output to responders, so the entire team has immediate access to the coordination channel.