Microsoft Teams Notifications

ApiMeld sends Teams notifications via Incoming Webhooks — a Teams connector that posts messages to a channel.

1. Create a Teams Incoming Webhook

For Teams channels (classic connectors)

1. In Teams, navigate to the channel you want to post to
2. Click the ⋯ (More options) next to the channel name → Connectors
3. Search for Incoming Webhook and click Configure
4. Give it a name (e.g. "ApiMeld") and optionally upload a logo
5. Click Create
6. Copy the webhook URL — it looks like:

   https://yourorg.webhook.office.com/webhookb2/...

7. Click Done

For Teams channels (new webhook approach — 2024+)

Microsoft is migrating away from Office 365 Connectors to Workflows. If you don't see the Connectors option:

1. In the channel, click ⋯ → Workflows
2. Search for "Post to a channel when a webhook request is received"
3. Follow the setup wizard
4. Copy the webhook URL provided at the end

Both URL formats work with ApiMeld.

2. Add the webhook to ApiMeld

1. Go to Admin → Settings → Notifications
2. Under Teams Webhooks, click Add
3. Enter a name (e.g. "IT Ops Team", "Dev Channel") and paste the webhook URL
4. Click Save

3. Enable on a task

1. Open a task and go to the Notifications tab
2. Select the Teams webhook(s) to notify
3. Choose the trigger events: On Success, On Failure, On Timeout
4. Save the task

Message format

ApiMeld posts an Adaptive Card to Teams containing:

• Task name and status with colour coding (green/red/orange)
• Start time and duration
• Output summary
• A link to the full run log in ApiMeld

Testing the webhook

After saving, click Test next to the webhook in Admin → Settings → Notifications to send a test card to the Teams channel.

Multiple channels

You can add multiple Teams webhooks pointing to different channels or teams. For example, post failures to #infrastructure-alerts and successes to #apimeld-log.