Microsoft Teams

The Microsoft Teams platform allows you to send notifications from Home Assistant to a team channel in Microsoft Teams.


To send a notification to teams, you need to add the Incoming Webhook app to your team channel. When the app is added, you will receive a webhook URL that needs to be added to your configuration.yaml.


To add the Microsoft Teams platform to your installation, add the following to your configuration.yaml file:

  - platform: msteams

Configuration Variables



Setting this parameter allows multiple notifiers to be created. The notifier will bind to the service notify.NOTIFIER_NAME.

Default value:




The webhook URL created in the setup step.

Microsoft Teams service data

The following attributes can be placed inside data for extended functionality.

Service data attribute Optional Description
image_url yes Attach an image to the message.

Example for posting file from URL:

title: Title of the message.
message: Message that will be added.
  image_url: URL_OF_IMAGE