Authorization

The Microsoft Teams connector is authorized using Oauth2. When you add a Microsoft Teams card to a flow for the first time, you'll be prompted to create a connection.

Tip

You can create multiple connections and manage them from your Connections page.

Supported Scopes for Microsoft Teams

During authorization users will be asked to approve the following scopes:

  • email
  • openid
  • profile
  • offline_access
  • Team.Create
  • Group.ReadWrite.All
  • Directory.ReadWrite.All
  • TeamMember.ReadWrite.All
  • ChannelMember.ReadWrite.All
  • Channel.Create

  • ChannelSettings.ReadWrite.All

  • ChannelMessage.Send

  • Chat.ReadWrite

Create Channel card

  • Private channel requires an owner.

  • When created, public channels don't require members.

  • The User ID is the Office 365 Admin User ID.

Prerequisites

  • Microsoft Teams admin account

  • Microsoft Teams admin credentials

  • The user account used to create the Workflows connection requires a Microsoft Teams license

To authorize an Microsoft Teams account and grant it the necessary properties to create an account for use with Workflows:

  1. Navigate to your Microsoft Teams console.

  2. Click Enterprise applicationsConsent and permissionsUser consent settings.

  3. Select Allow user consent to apps.

  4. Select Allow group owner consent for all group owners.

To create a new connection:

  1. Click New Connection.

  2. Add a Connection Nickname. This is useful if you plan to create multiple connections to share with your team.

  3. Click Create.

  4. In the Oauth window, log in with your Microsoft Teams administrator account.

Related topics

Microsoft Teams connector

About the elements of Okta Workflows

Microsoft Teams API overview