> ## 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.

# Send message to Teams chat

> Send a message to a Microsoft Teams chat from a Workflow.

Use the **Send Message to Teams Chat** action to send a message to a Microsoft Teams chat as part of a [Workflow](/workflows/overview). You can also reply to the chat that triggered the Workflow.

## Set up the action

<Steps>
  <Step title="Add the action">
    While editing a Workflow, click the **+** button between existing blocks. Select **Send Message to Teams Chat** from the action list.

    <Frame>
      <img src="https://mintcdn.com/cassidy/g8fyfImJ_SyinsRX/images/reference/send-message-to-teams-chat-img-0.png?fit=max&auto=format&n=g8fyfImJ_SyinsRX&q=85&s=754b714a0b7fb4734ced5f889a69e0ac" alt="Selecting the Send Message to Teams Chat action" width="966" height="598" data-path="images/reference/send-message-to-teams-chat-img-0.png" />
    </Frame>
  </Step>

  <Step title="Rename the action (optional)">
    Click the action name to give it a more descriptive label.

    <Frame>
      <img src="https://mintcdn.com/cassidy/g8fyfImJ_SyinsRX/images/reference/send-message-to-teams-chat-img-1.png?fit=max&auto=format&n=g8fyfImJ_SyinsRX&q=85&s=811a9b17167e9b4f90122e4ae45c1541" alt="Renaming the Send Message to Teams Chat action" width="1006" height="158" data-path="images/reference/send-message-to-teams-chat-img-1.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/g8fyfImJ_SyinsRX/images/reference/send-message-to-teams-chat-img-2.png?fit=max&auto=format&n=g8fyfImJ_SyinsRX&q=85&s=8a18b2d4b9518a5647b118659296955e" alt="Adding a Microsoft Teams connection" width="1004" height="1752" data-path="images/reference/send-message-to-teams-chat-img-2.png" />
    </Frame>

    <Warning>The Microsoft Teams connection requires admin approval. See [Microsoft's admin consent workflow documentation](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/configure-admin-consent-workflow) for details.</Warning>
  </Step>

  <Step title="Toggle on reply to trigger message (optional)">
    If you're using this action with the **New Teams Chat Message** trigger, enable **Reply to Trigger Message** to reply to the same chat that started the Workflow. When enabled, you only need to fill out the **Message** field.

    <Frame>
      <img src="https://mintcdn.com/cassidy/g8fyfImJ_SyinsRX/images/reference/send-message-to-teams-chat-img-3.png?fit=max&auto=format&n=g8fyfImJ_SyinsRX&q=85&s=088080e65dcd9b3635070f62bf9b605b" alt="Reply to Trigger Message toggle" width="1008" height="156" data-path="images/reference/send-message-to-teams-chat-img-3.png" />
    </Frame>
  </Step>

  <Step title="Select the chat">
    Select the chat to send a message to. You can also click the pencil icon to enter the chat ID directly.

    <Tip>This field is only required if **Reply to Trigger Message** is not toggled on.</Tip>

    <Frame>
      <img src="https://mintcdn.com/cassidy/g8fyfImJ_SyinsRX/images/reference/send-message-to-teams-chat-img-4.png?fit=max&auto=format&n=g8fyfImJ_SyinsRX&q=85&s=a8a2d5a128da0ed58ebf5344cd8cd37e" alt="Chat selector field" width="1010" height="228" data-path="images/reference/send-message-to-teams-chat-img-4.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cassidy/g8fyfImJ_SyinsRX/images/reference/send-message-to-teams-chat-img-5.png?fit=max&auto=format&n=g8fyfImJ_SyinsRX&q=85&s=60677e9b1bb162e73f19e61d1c9d91a2" alt="Chat selection with variable reference" width="1016" height="218" data-path="images/reference/send-message-to-teams-chat-img-5.png" />
    </Frame>
  </Step>

  <Step title="Enter the message">
    Enter the message to send to the chat. You can type directly or reference a variable from a previous step or the trigger.

    <Frame>
      <img src="https://mintcdn.com/cassidy/g8fyfImJ_SyinsRX/images/reference/send-message-to-teams-chat-img-6.png?fit=max&auto=format&n=g8fyfImJ_SyinsRX&q=85&s=e56b60e3c6e8def3a3c95085ad817515" alt="Message field with variable reference" width="1012" height="546" data-path="images/reference/send-message-to-teams-chat-img-6.png" />
    </Frame>
  </Step>
</Steps>

## Related

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

  <Card title="Send channel message" icon="hashtag" href="/integrations/microsoft-365/teams/send-channel-message">
    Send a message to a Teams channel from a Workflow.
  </Card>
</CardGroup>
