home-assistant.io/source/_integrations/application_credentials.markdown
2022-10-05 18:25:01 +02:00

2.1 KiB

title description ha_release ha_domain ha_quality_scale ha_category ha_codeowners ha_integration_type
Application Credentials Allows users to link accounts with integrations that support OAuth2 2022.6 application_credentials internal
@home-assistant/core
system

The Application Credentials integration is used by integrations that use OAuth2 to link your account to Home Assistant. The most common and preferred approach is using account linking with Home Assistant Cloud, however not all cloud providers support that and integrations can use Application Credentials instead. Additionally, users may use Application Credentials if preferred instead of Home Assistant Cloud Account Linking.

Automatic Setup

Some integrations like Google Calendar will automatically create application credentials as part of adding an integration. To view any entries:

  1. Go to {% my integrations title="Settings -> Devices & Services" %}
  2. Click the overflow menu on the top right ... and choose Application Credentials

Devices and services overflow menu

Application credential list

Manual Setup

Note that integrations that do not support cloud linking will prompt to setup Application Credentials when setting up for the first time. You may also manually enter credentials with the following steps:

  1. Obtain an OAuth Client ID and Client Secret from the cloud provider. The integration should have specific instructions for this.
  2. In Home Assistant navigate to {% my integrations title="Settings -> Devices & Services" %}
  3. Click the overflow menu on the top right ... and choose Application Credentials
  4. Select the integration, enter a Name and your OAuth Client ID and Client Secret.
  5. Save the credentials

Manual setup

You may then visit Integrations and setup the integration.