Authentication
This provider requires authentication.- webhook_url: Teams Webhook Url (required: True, sensitive: True)
In workflows
This provider can be used in workflows. As “action” to make changes or update data, example:- create_jira_ticket_upon_alerts.yml
- teams-adaptive-card-notifier.yaml
- teams-adaptive-cards-with-mentions.yaml
Connecting with the Provider
- In the New Teams client, select Teams and navigate to the channel where you want to add an Incoming Webhook. 2. Select More options ••• on the right side of the channel name. 3. Select Manage Channel

For members who aren’t admins of the channel, the Manage channel option is
available under the Open channel details option in the upper-right corner
of a channel.
- Select Edit

- Search for Incoming Webhook and select Add.

- Select Add

- Provide a name for the webhook and upload an image if necessary. 8. Select Create.

- Copy and save the unique webhook URL present in the dialog. The URL maps to the channel and you can use it to send information to Teams. 10. Select Done. The webhook is now available in the Teams channel.

Notes
When using Adaptive Cards (typeCard="message"
):
- The
sections
parameter should follow the Adaptive Cards schema themeColor
is ignored for Adaptive Cards- If no sections are provided, the message will be displayed as a simple text block
- Both
sections
andattachments
can be provided as JSON strings or arrays - You can mention users in your Adaptive Cards using the
mentions
parameter
Workflow Example
You can also find this example in our examples folder in the Keep GitHub repository.The sections parameter is a JSON string that follows the Adaptive Cards schema, but can also be an object.
If it’s a string, it will be parsed as a JSON string.
Using Sections
Using Custom Attachments
Using User Mentions in Adaptive Cards
You can mention users in your Adaptive Cards using thementions
parameter. The text in your card should include the mention in the format <at>User Name</at>
, and you need to provide the user’s ID and name in the mentions
parameter.
Teams supports three types of user IDs for mentions:
- Teams User ID (format:
29:1234...
) - Microsoft Entra Object ID (format:
49c4641c-ab91-4248-aebb-6a7de286397b
) - User Principal Name (UPN) (format:
[email protected]
)
Useful Links
- https://learn.microsoft.com/pt-br/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook
- https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using
- https://adaptivecards.io/explorer/
- https://adaptivecards.io/schemas/adaptive-card.json