Microsoft Teams

Microsoft Teams is a first-class target for Webhook Notifier, with proper Adaptive Card support. This page covers getting a webhook URL out of Teams and pointing a connection at it.

Why the setup changed

Teams used to offer simple "Incoming Webhook" connectors. Microsoft retired those in 2026, and the supported replacement is Power Automate Workflows. Workflows expect an Adaptive Card wrapped in a particular envelope, which is fiddly to build by hand - so Webhook Notifier builds and wraps the card for you. All you provide is the workflow's URL.

Creating the workflow in Teams

1. In Teams, open the channel you want to post to, then ⋯ (more options) → Workflows.
2. Choose the template "Post to a channel when a webhook request is received".
3. Complete the wizard while signed in as a member of that team. This matters - see Troubleshooting. If you set the workflow up as someone who isn't in the team, Teams will accept the flow but reject the posts.
4. When it finishes, copy the HTTP POST URL it gives you.

Complete the wizard as a member of the team

Teams will happily let someone outside the team create the flow, then refuse every post it makes with a 401. If that's already happened, recreate the workflow from inside the channel while signed in as a team member - see Troubleshooting.

Pointing a connection at it

1. In Craft, go to Webhook Notifier → Connections → New.
2. Give it a name like "Teams: #deploys".
3. Paste the HTTP POST URL (or store it in an environment variable and enter $YOUR_ENV_VAR - see Connections).
4. Save, then click Send a test to fire a sample card at the channel. If it arrives, you're set. If it doesn't, open the delivery log to see exactly what Teams returned.

Building Teams cards in a rule

With the connection in place, create a rule and choose one of the two Teams-oriented payload modes:

• Structured - fill in a title, body, facts and an optional button, and the plugin assembles the Adaptive Card. No JSON needed.
• Advanced - write the full Adaptive Card JSON yourself, optionally starting from one of the built-in examples.

Either way, the plugin wraps the card in the Power Automate envelope Teams requires, so you never have to build that part. See Payloads and cards for the detail on both modes.

Adaptive Card version

New cards target Adaptive Card schema 1.5 by default. You can change the default in Settings (defaultCardVersion) if you need a different version for the features you're using.

Trademark notice

"Microsoft", "Microsoft Teams", and "Power Automate" are trademarks of the Microsoft group of companies. This plugin is an independent product and is not affiliated with, endorsed by, or sponsored by Microsoft.