Account linking migration guide

Google is transitioning third-party smart home account linking to be handled fully and independently within the Google Home app (GHA), retiring legacy dependencies on the Google Search app and Google Assistant settings.

Core backend OAuth 2.0 infrastructure, credentials, and fulfillment webhooks remain unchanged. Partners need to update in-app and web deep links, App Flip allowlists (if supported), and customer-facing setup instructions.

Review your integrations to verify whether the following changes are needed. If your integration relies on in-app deep links or App Flip, these updates must be completed by September 30, 2026 to avoid failures with in-app linking attempts.

If your app or product website provides a Link with Google or Connect to Google Home button, update the destination URLs to target the GHA directly.

Platform and integration type Legacy destination New destination (Google Home app)
Universal Link (Web, iOS, and Android) https://madeby.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id https://home.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id
Custom scheme (Android and iOS) assistant-settings://?feature=home_automation&agent_id=agent-id googlehome://setup/ha_linking?agent_id=agent-id

Update App Flip allowlists

If your integration supports App Flip and your app or server enforces allowlist security checks, update your allowlists to include the GHA.

For Android app verification

If your Android application validates package names or signing certificates, add the GHA package name and SHA-256 release signature to your allowlist:

  • Package name: com.google.android.apps.chromecast.app
  • SHA-256 fingerprint: 3D:7A:12:23:01:9A:A3:9D:9E:A0:E3:43:6A:B7:C0:89:6B:FB:4F:B6:79:F4:DE:5F:E7:C2:3F:32:6C:8F:99:4A
  • App Flip requests originate directly from com.google.android.apps.chromecast.app rather than com.google.android.googlequicksearchbox.

For iOS server allowlists

Ensure your OAuth authorization server allows the Google Home redirect URI:

  • Production: https://oauth-redirect.googleusercontent.com/a/com.google.Chromecast

Update customer support and setup documentation

Review and update user manuals, packaging inserts, support FAQs, and online knowledge bases:

  • Remove instructions asking users to open the Google Search app or Google Assistant settings.
  • Adopt standardized Google Home phrasing, such as:

References

For additional background and implementation details, see the Deep linking guide and App Flip guide.

For questions about this migration, or if you need help, see the Cloud-to-cloud Support page to learn how to contact Google.