Skip to content

Teams

Attention

Microsoft has changed the URL scheme for Teams webhooks. You will now have to specify the hostname using: 

?host=example.webhook.office.com
Where example is your organization short name

URL Format

teams://group@tenant/altId/groupOwner?host=organization.webhook.office.com

URL Fields

  • Group
    Default: empty
    URL part: teams://group@tenant/altid/groupowner
  • Tenant
    Default: empty
    URL part: teams://group@tenant/altid/groupowner
  • AltID
    Default: empty
    URL part: teams://group@tenant/altid/groupowner
  • GroupOwner
    Default: empty
    URL part: teams://group@tenant/altid/groupowner

Query/Param Props

Props can be either supplied using the params argument, or through the URL using
?key=value&key=value etc.

  • Color
    Default: empty

  • Host
    Default: outlook.office.com

  • Title
    Default: empty

Setting up a webhook

To be able to use the Microsoft Teams notification service, you first need to set up a custom webhook. Instructions on how to do this can be found in this guide

Extracting the token

The token is extracted from your webhook URL:

https://<organization>.webhook.office.com/webhookb2/<group>@<tenant>/IncomingWebhook/<altId>/<groupOwner>