Microsoft Teams (Lite) Trigger icon

Microsoft Teams (Lite) Trigger

Triggers workflows in n8n based on events from Microsoft Teams, such as new messages or team updates, using specified configurations. It uses minimal permissions

Microsoft Teams (Lite) Trigger

AI-generated

Summary

Triggers workflows on Microsoft Teams events based on webhook notifications.

Inputs

  • event — Select the event to trigger the workflow. Default: newChatMessage. Options: newChatMessage (message posted to a chat), newChannelMessage (message posted to a channel), newChat (new chat created), newChannel (new channel created), newTeamMember (new member joins a team).
  • watchAllChats — Whether to watch for the event in all the available chats. Default: false. Only shown when event is newChatMessage.
  • chatId (required) — Select a chat from the list, enter an ID, or enter a URL. Required when event is newChatMessage and watchAllChats is false. Modes: From List (searchable via getChats), By ID, By URL (extracts conversation ID via regex).
  • teamId (required) — Select the team from the list, by URL, or by ID (groupId). Required when event is newChannel, newChannelMessage, or newTeamMember. Modes: From List (searchable via getTeams), By ID (validates as Microsoft Teams Team ID regex).
  • watchAllChannels — Whether to watch for the event in all channels of the selected team. Default: false. Only shown when event is newChannelMessage.
  • channelId (required) — Select the channel from the list, by URL, or by ID. Required when event is newChannelMessage and watchAllChannels is false. Modes: From List (depends on teamId, searchable via getChannels), By ID (threadId in URL).
  • fetchFullMessage — Whether to fetch the full message content from the API. Default: false. When disabled, only notification metadata (IDs) is returned. Shown for events newChatMessage and newChannelMessage.
  • ignoreOwnMessages — Whether to ignore messages sent by the authenticated user. Default: false. Useful to prevent loops when a workflow both sends and listens for messages. Shown for events newChatMessage and newChannelMessage.

Output shape

Array of JSON objects. Each object includes the notification's resourceData and/or full message content from Microsoft Graph API, supplemented with metadata _subscriptionId and _tenantId. If fetchFullMessage is disabled and ignoreOwnMessages is disabled, only notification metadata (IDs) is returned. If fetchFullMessage is enabled, the full message content is included.

Returns { noWebhookResponse: true } if no relevant notifications are received.

Links

Discussion