How to register your own Google Health OAuth app

1. Go to the Google Cloud Console.
2. Click the project selector at the top of the page.
3. Click New project.
4. Enter a project name.
5. Select the organization or folder where the project belongs.
6. Click Create and select the new project.

1. In the Google Cloud Console, open APIs & Services > Library.
2. Search for Google Health API.
3. Select the API and click Enable.

1. Open APIs & Services > OAuth consent screen.
2. Click Get started.
3. Enter the app name and user support email.
4. Select the audience for your app:
   • External for apps available to any Google user
   • Internal for apps restricted to your Google Workspace organization
5. Add your contact email addresses.
6. Add the required app URLs, including your application website, privacy policy, and terms of service.
7. Add authorized domains for the domains that host your app.

If your OAuth consent screen is in Testing mode, add each test user before they authorize the app.

1. Open APIs & Services > OAuth consent screen > Audience.
2. Under Test users, click Add users.
3. Enter each Google account email address that should be allowed to authorize your app.
4. Click Save.

1. Open APIs & Services > OAuth consent screen > Data access.
2. Click Add or remove scopes.
3. Search for Google Health API.
4. Select only the scopes your app needs.
5. Click Update, then Save.

Common read scopes include:

https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly
https://www.googleapis.com/auth/googlehealth.profile.readonly
https://www.googleapis.com/auth/googlehealth.sleep.readonly

Use write-only scopes only when your app creates, updates, or deletes Google Health data.

1. Open APIs & Services > Credentials.
2. Click Create credentials and select OAuth client ID.
3. Select Web application as the application type.
4. Enter a name for the OAuth client.
5. Under Authorized redirect URIs, add https://api.tenklo.dev/oauth/callback.
6. If you test from the Tenklo dashboard, add https://app.tenklo.dev under Authorized JavaScript origins.
7. Click Create.
8. Copy the client ID and client secret.

1. In Tenklo, open Integrations and configure a new Google Health integration.
2. Paste the Google OAuth client ID and client secret.
3. Add the same Google Health scopes you configured on the OAuth consent screen.
4. Save the integration.

Follow the Quickstart to connect your first Google Health account.

Most production Google Health apps need OAuth app verification, and apps with more than 100 users require a third-party security review.

1. Follow the Google app and security review guide.
2. After approval, open APIs & Services > OAuth consent screen > Audience.
3. Click Publish app to move from Testing to Production.