Channel

Channel works with Microsoft Teams teams and channels: it lists the teams you belong to, the channels in a team and the members of a channel, and it creates new channels.

It is useful for organising Teams automatically, for example by creating a channel per project, and as a first step for Channel Messages when a flow needs to know which channels it can post in.

When to use it

• When a project starts, you want to create its channel in the right team.
• An AI agent needs to know which channels exist in a team before posting a notice.
• You want the list of members of a channel to send them a summary by email.
• You need a list of an account’s Teams teams.

Configuration

You need a Microsoft Teams credential, which connects by signing in with your Microsoft account. See Credentials.

Field	What it does
Credential (required)	The Microsoft Teams credential used to access your teams. Choosing it loads your teams and channels.
Operation (required)	What the component does. See Operations. By default, Get Teams.
Teams ID	The team you work with, picked by name. Changing it reloads the list of channels. In Get Teams Channels, Get Channel Members and Create Channel.
Channel ID	The channel, picked by name. Only in Get Channel Members.
Channel Name	The name of the new channel. Only in Create Channel.
Channel Description	The description of the new channel. Only in Create Channel.
Channel Type	standard (visible to the whole team) or private (only for the people added to it). By default, standard. Only in Create Channel.

Operations

Operation	What it does
Get Teams	Lists the teams you belong to, with their identifier, name and description.
Get Teams Channels	Lists the channels in a team, with their identifier, name, description and type.
Get Channel Members	Lists the members of a channel, with their name, email and role.
Create Channel	Creates a new channel in the team.

Output

The Data output returns one item for each team, channel or member found, or a single item with the channel created and its identifier.

You can connect the result to Channel Messages to post in the channel, or to an email component. The component can also be connected to an Agent as a tool, so the agent decides when to look up teams or create channels. See Tool Mode.

Example

A consultancy creates a Teams channel for every new project it signs.

1. When a project is signed, the flow receives its name and a short description.
2. Add Channel with the Create Channel operation and the consultancy’s Microsoft Teams credential.
3. In Teams ID, pick the Projects team; in Channel Name, the project’s name; and in Channel Description, the description.
4. Connect the Data output to Channel Messages to post a welcome message in the new channel.

Related components

• Channel Messages: send and read messages in channels.
• Chats: look up your chats and their members.
• Teams Webhook: start a flow when something happens in Teams.