Microsoft Teams

Send notifications to Teams channels via incoming webhooks.

URL format

scheme

msteams://group_id[@tenant_id]/channel_id/webhook_id

Segment	Required	Description
`group_id`	Yes	GUID before the `@` in the webhookb2 path segment
`tenant_id`	No	GUID after the `@`. Leave blank if not present.
`channel_id`	Yes	Path segment after `/IncomingWebhook/`
`webhook_id`	Yes	Final path segment in the Teams webhook URL

Example

typescript

import { notify } from '@ambersecurityinc/notifly';

await notify(
  { urls: ['msteams://groupGUID@tenantGUID/channelID/webhookID'] },
  { title: 'Release', body: 'v3.0 deployed successfully', type: 'success' }
);

Finding your credentials

Open the Teams channel you want to post to.
Click the … (More options) next to the channel name.
Select Connectors → Incoming Webhook → Configure.
Give it a name and click Create.

Copy the webhook URL — it will look like:

teams webhook url

https://your-org.webhook.office.com/webhookb2/GROUP_GUID@TENANT_GUID/IncomingWebhook/CHANNEL_ID/WEBHOOK_ID

Quirks & limitations

Microsoft Teams is deprecating connector webhooks in favour of workflows. Check your org's policies.
The type field maps to Teams message card themeColor: success → green, failure → red, warning → orange.