Microsoft Teams steps

Flow Designer has built-in steps to help you integrate Microsoft Teams into your event management and incident response flows.

The following steps are available:

  • Create Channel: create a new channel in Teams, using the inputs to construct the channel name and description, and to determine the team to create the channel in.
  • Delete Channel: delete an xMatters generated channel in Teams, using the inputs to determine the channel to delete.
  • Post Message: post a simple message to a channel, using HTML to format plain text, outputs from previous steps, or a combination of both.
  • Post to Channel (Connector) - deprecated: post a message to a channel using a webhook connector you configure in Microsoft Teams. This allows you to post to the channel using a card format. This step will be deprecated by Microsoft at the end of 2025. To ensure your flows continue to work properly use the Post Message step instead.
  • Create Online Meeting: create a new instant meeting in Teams, using inputs to construct the meeting subject.

Add Microsoft Teams steps to your flow

  1. To add a Teams step to your flow, go to the Apps panel in the palette, expand the Microsoft Teams steps, and drag the step onto the canvas.
  2. Connect the step to the previous step in the flow so you have access to the alert properties and outputs of previous steps when configuring this step's inputs.
  3. Double-click the step to edit it, and use the Setup tab to configure the inputs. You can use plain text and input variables (or both). See the sections below for detailed information on the inputs for the step.
  4. On the Endpoint tab, configure the step to point to the appropriate endpoint:
    • For Create Channel and Post Message, select a Microsoft Graph API endpoint.
    • For Post to Channel (Connector), select the endpoint using the Teams webhook URL.
    • For Create Meeting, select the Microsoft Graph API endpoint.

Create Channel

Use the Create Channel step to automatically create a new channel in a team, using text, constants, and the outputs from previous steps to populate the inputs.

To use the Create Channel step you need to create a Microsoft Graph API endpoint.

Delete Channel

Use the Delete Channel step to automatically delete a channel created by xMatters in Teams, using text, constants, and the outputs from previous steps to populate the inputs.

Deleted channels in Microsoft Teams can be restored within 30 days. During this period, deleted channels continue to count toward your Microsoft Teams channel limits. For more information, see Limits and specifications for Microsoft Teams.

Post Message

Use the Post Message step to send a message to a channel in a team, using text, constants, and the outputs from previous steps to populate the inputs.

To use Post Message step, you need to create a Microsoft Graph API endpoint.

Post to Channel (Connector) - deprecated

This step will be deprecated by Microsoft at the end of December 2025. To ensure your flows work as expected, use the Post Message step instead.

Use the Post to Channel step to automatically post a message to a channel in Microsoft Teams, using the input to populate the message.

To use this step, you need to set up an incoming webhook connector in your Microsoft Teams channel. You can find details in the Microsoft Teams help. Use the unique URL generated when you set up the connector as the Base URL when you configure an endpoint in xMatters.

Create Online Meeting

Use the Create Online Meeting step to automatically create a new instant meeting, using text, constants, and the outputs from previous steps to populate the inputs. Outputs of this step include a URL users can click to join the meeting (instant meetings are not automatically added to the calendar), as well as dial-in information if audio conferencing is available for the meeting.