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.
- Navigate to the Integrations section
- Add this repository as a Custom Repository (Integration) via the menu at top right.
- Search for “Microsoft 365 To Do”
- Select “Install this repository”
- Restart Home Assistant
- Go to the Home Assistant Devices configuration page
- Click “Add Integration”
- Search for “Microsoft 365 Contacts”
- 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. |