Installation and Configuration

This page details the configuration details for this integration. General instructions can be found on the MS365 Home Assistant Installation and Configuration page.

Configuration variables

Key Type Required Description
entity_name string True Uniquely identifying name for the account. Do not use email address or spaces.
client_id string True Client ID from your Entra ID App Registration.
client_secret string True Client Secret from your Entra ID App Registration.
alt_auth_method boolean False If False (default), authentication is not dependent on internet access to your HA instance. See Authentication
shared_mailbox string False Email address or ID of shared mailbox (This should not be the same email address as the loggin in user).

Advanced API Options

These options will only be relevant for users in very specific circumstances.

Key Type Required Description
country string True Selection of an alternate country specific API. Currently only 21Vianet from China and MS365 GCC.
tenant_id string False Azure tenant ID for single-tenant app registrations. Leave blank for multi-tenant apps.