Skip to main content

Get Channel

Gets a channel in Microsoft Teams 365.

This node is also exposed as an AI Agent tool.

This node has 1 input port and 1 output port.

Common Properties​

Every node shares these.

  • Name — the node's display name on the canvas.
  • Color — the node's colour on the canvas.
  • Delay Before (sec) — wait this long before the node runs.
  • Delay After (sec) — wait this long after the node runs.
  • Continue On Error — carry on instead of failing the flow. Defaults to false.
info

When Continue On Error is true the error is not raised at all, so a Catch node will not see it either.

Inputs​

PropertyFieldDescription
Channel IDinChannelIDID of the channel to retrieve
Client IDinClientIDClient ID from Connect node (optional if credentials provided)
Team IDinTeamIDID of the team containing the channel

Outputs​

PropertyFieldDescription
ChanneloutChannelChannel details including id٫ display_name٫ description٫ web_url٫ and membership_type

Options​

PropertyFieldDescription
CredentialsoptCredentialsMicrosoft 365 credentials (optional - use instead of Connect node)

Requirements​

  • A Client ID from this package's Connect node, unless you set credentials directly on this node.
  • Azure AD App (Client Credentials) — Use Azure AD app registration with client credentials for server-to-server authentication.
    • tenant_id — Tenant ID (text, required). Azure AD tenant ID (Directory ID)
    • client_id — Application (Client) ID (text, required). Azure AD application (client) ID
    • client_secret — Client Secret (password, required). Azure AD application client secret
    • user_email — User Email (for delegated operations) (text, optional). Email of user to impersonate for operations requiring user context (e.g. sending messages)
  • OAuth2 (Delegated) — Authorize via browser to access Teams on behalf of a user.
    • _redirect_url — Redirect URL (readonly, optional). Add this to your Azure app's Redirect URIs
    • tenant_id — Tenant ID (text, required). Azure AD tenant ID، or 'common' for multi-tenant
    • client_id — Application (Client) ID (text, required). Azure AD application (client) ID
    • client_secret — Client Secret (password, required). Azure AD application client secret

Store these in a Vault and reference the vault item from the node, rather than typing the secret into the property.

List Channels · Create Channel · Update Channel · Delete Channel

Elsewhere in the package: Connect · Disconnect · List Teams · Get Team · Send Channel Message · List Channel Messages · Reply to Message · List Team Members · Add Team Member · Remove Team Member and 3 more

See also​