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.

  1. Navigate to the Integrations section
  2. Add this repository as a Custom Repository (Integration) via the menu at top right.
  3. Search for “Microsoft 365 To Do”
  4. Select “Install this repository”
  5. Restart Home Assistant
  6. Go to the Home Assistant Devices configuration page
  7. Click “Add Integration”
  8. Search for “Microsoft 365 Contacts”
  9. Click on the result, and follow the prompts.

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.