Search Channels

Search for Microsoft Teams channels.

Options

Field Definition Type Required

Result Set

Choose one of the following options to display your search results:

  • First Matching Record: Returns the first matching teams.
  • First 200 Matching Records: Returns the first 200 matching teams.

Dropdown

TRUE

Search By

Choose whether to return teams that are an Exact Match of the search or Starts With the search expression.

Dropdown

TRUE

Input

Field Definition Type Required

Team

Id

Unique identifier of the team.

Text

TRUE

Search

Display Name

Display name of the channel. Maximum 50 characters.

Appears when you select Exact Match or Starts With as the Search By option.

Text

FALSE

Description

Description for the channel.

Appears when you select Exact Match or Starts With as the Search By option.

Text

FALSE

Membership Type

Type of the channel. Possible values are:

  • Standard: Channel inherits the list of all members of the parent team.

  • Private: Channel can have members that are a subset of all the members on the parent team. Limit of 30 private channels per team.

Appears when you select Exact Match as the Search By option.

Dropdown

FALSE

Output

Field Definition Type

Channels

Id

Unique identifier of the channel.

Text

Display Name

Display name of the channel. The default setting is message.

Text

Membership Type

Specifies the type of the channel.

Text

Description

Description for the channel.

Text

Email

Email address for sending messages to the channel.

Text

Is Favorite By Default?

Indicates whether the channel should automatically be marked as recommended for all members of the team.

True/False

Created Date Time

Date and time that the channel was created.

Date & Time

Related topics

Microsoft Teams connector

Workflow elements

Guidance for Microsoft Teams connector

Microsoft Teams API overview