> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# New Teams channel message trigger

> Run a Workflow automatically when a message is posted in a Microsoft Teams channel.

Use the **New Teams Channel Message** trigger to start a [Workflow](/workflows/overview) whenever a new message is posted in a specific Microsoft Teams channel. This is useful for monitoring channels for requests, routing messages, or automating responses.

## Set up the trigger

<Steps>
  <Step title="Add the trigger">
    Create a new Workflow with the **New Teams Channel Message** trigger, or change an existing Workflow's trigger type to **New Teams Channel Message**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RuRQFQTAAAcziOuR/images/reference/new-teams-channel-message-trigger-img-0.png?fit=max&auto=format&n=RuRQFQTAAAcziOuR&q=85&s=90ca4c536083d3d77f6f65187b00e4b8" alt="Selecting the New Teams Channel Message trigger" width="882" height="344" data-path="images/reference/new-teams-channel-message-trigger-img-0.png" />
    </Frame>
  </Step>

  <Step title="Connect your Microsoft Teams account">
    If you haven't already, connect your Microsoft Teams account to Cassidy.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RuRQFQTAAAcziOuR/images/reference/new-teams-channel-message-trigger-img-1.png?fit=max&auto=format&n=RuRQFQTAAAcziOuR&q=85&s=c14c51d7b2a4ceb716278707d36cb62f" alt="Adding a Microsoft Teams connection" width="1010" height="1228" data-path="images/reference/new-teams-channel-message-trigger-img-1.png" />
    </Frame>

    <Warning>The Microsoft Teams connection requires admin approval. Either have an admin check the **Consent on behalf of your organization** checkbox during the connection process, or follow the [admin consent workflow process](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/configure-admin-consent-workflow) outlined in Microsoft's documentation.</Warning>
  </Step>

  <Step title="Select the team">
    Choose the specific team that contains the channel you want to monitor.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RuRQFQTAAAcziOuR/images/reference/new-teams-channel-message-trigger-img-2.png?fit=max&auto=format&n=RuRQFQTAAAcziOuR&q=85&s=dc26b50b54fd5c7ae1b6f4f3bcbfb251" alt="Selecting a team to monitor" width="1010" height="230" data-path="images/reference/new-teams-channel-message-trigger-img-2.png" />
    </Frame>
  </Step>

  <Step title="Select the channel">
    Choose the specific channel within the selected team. The Workflow will trigger when new messages are posted in this channel.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RuRQFQTAAAcziOuR/images/reference/new-teams-channel-message-trigger-img-3.png?fit=max&auto=format&n=RuRQFQTAAAcziOuR&q=85&s=25f48f4913165f13125dfe109a053368" alt="Selecting a channel within the team" width="1014" height="220" data-path="images/reference/new-teams-channel-message-trigger-img-3.png" />
    </Frame>
  </Step>

  <Step title="Reference the trigger variables">
    In subsequent Workflow steps, you can reference the following variables:

    * **Message Sender** — the person who sent the message
    * **Subject** — the subject of the message
    * **Message Contents** — the text content of the message
    * **Message URL** — the URL of the message
    * **Message ID** — the unique identifier of the message
    * **Team ID** — the unique identifier of the team
    * **Channel ID** — the unique identifier of the channel
    * **Attachments** — any attachments on the message

    <Frame>
      <img src="https://mintcdn.com/cassidy/RuRQFQTAAAcziOuR/images/reference/new-teams-channel-message-trigger-img-4.png?fit=max&auto=format&n=RuRQFQTAAAcziOuR&q=85&s=9c42966957a7b66e75a487216db79b90" alt="Available Teams channel message trigger variables" width="1494" height="762" data-path="images/reference/new-teams-channel-message-trigger-img-4.png" />
    </Frame>
  </Step>

  <Step title="Activate the trigger">
    In the trigger block, click the toggle switch to turn it on.

    <Frame>
      <img src="https://mintcdn.com/cassidy/RuRQFQTAAAcziOuR/images/reference/new-teams-channel-message-trigger-img-5.png?fit=max&auto=format&n=RuRQFQTAAAcziOuR&q=85&s=480d76c74a6eec1dd6fd0fa18023d5ac" alt="Activating the Teams channel message trigger toggle" width="884" height="440" data-path="images/reference/new-teams-channel-message-trigger-img-5.png" />
    </Frame>
  </Step>
</Steps>

## Related

<CardGroup cols={2}>
  <Card title="Send channel message" icon="paper-plane" href="/integrations/microsoft-365/teams/send-channel-message">
    Send a message to a Teams channel from a Workflow.
  </Card>

  <Card title="New chat message trigger" icon="comment" href="/integrations/microsoft-365/teams/new-chat-message-trigger">
    Trigger a Workflow from a Teams chat message.
  </Card>
</CardGroup>