Use Microsoft Teams Graph actions with Automation

You can connect your Microsoft Teams account with Jira and Jira Service Management Automation to retrieve teams, channel, and member information and use it in your automation rules.

Before you begin

To connect Microsoft Teams to Atlassian Automation, you must be a Jira admin.

Before you can use Microsoft Teams Graph actions in Automation, you must create a Microsoft connection and grant the required Microsoft Graph permissions.

  1. Add any Microsoft Teams Graph action to your automation rule.

  2. When prompted to choose a connection, select Create connection.

  3. Sign in with your Microsoft account and approve the requested permissions.

  4. Save and test the connection to confirm that Automation can access Microsoft Teams data.

The teams, channels, and members returned depend on the connected user's Microsoft Teams access and granted Graph permissions.

Scopes

You must include the scopes required by the actions you want to use:

  • Team.ReadBasic.All – required to list joined teams for a specified user and get team details.

  • Channel.ReadBasic.All – required to list channels in a team.

  • ChannelMember.Read.All – required to list members in a Teams channel.

Actions

List joined teams for user

List Microsoft Teams joined by a specific user. Use the results to discover teams for a given user ID or email.

Enter the following fields or select using smart values:

  • User identifier (required): Enter the Microsoft Entra user ID or user principal name. For example, alex@example.com or the user's Entra ID.

Get team details

Get details for a specific Microsoft Team by its ID. Retrieve the team name, description, and other metadata.

Enter the following fields or select using smart values:

  • Team ID (required): Enter the ID of the Microsoft Team to retrieve. For example, use the team ID returned by List joined teams.

List team channels

List channels in a specific Microsoft Team. Use the results to find or route work to the right channel.

Enter the following fields or select using smart values:

  • Team ID (required): Enter the ID of the Microsoft Team whose channels you want to list. For example, use the team ID returned by List joined teams.

List channel members

List members in a specific Microsoft Teams channel. Use the results for audit, routing, or membership checks.

Enter the following fields or select using smart values:

  • Team ID (required): Enter the ID of the team that contains the channel.

  • Channel ID (required): Enter the ID of the channel whose members you want to list. For example, use the channel ID returned by List team channels.

Learn more

 

Still need help?

The Atlassian Community is here for you.