📘
Availability
This workflow action is available on Business and Enterprise for Incident Management pricing plans. Contact the Sales Team to upgrade to an account with this action.

Description

Link a specified Microsoft Teams channel to an incident.

Instructions

If you have not done so, follow the instructions to Create an Incident Workflow.
When the instructions prompt you to add actions, select this action.
Enter the following Inputs and click Save.
Continue following instructions to Publish the Workflow.
When the action runs, you will see the Outputs listed below.

Inputs

📘
Field References
Fields with the {+} icon accept 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 article for more information.

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.