n8n-docs/docs/integrations/builtin/credentials/google/oauth-single-service.md

title, description, contentType, priority

title	description	contentType	priority
Google OAuth2 single service	Documentation for single service OAuth2 Google credentials. Use these credentials to authenticate Google in n8n, a workflow automation platform.	integration reference	critical

Google: OAuth2 single service

This document contains instructions for creating a Google credential for a single service. They're also available as a video.

Prerequisites

• Create a Google Cloud account.

Managed OAuth2

n8n Cloud users can use Managed OAuth2 for the following nodes:

--8<-- "_snippets/integrations/managed-google-oauth.md"

To use Managed OAuth2, just click Sign in with Google in the credentials screen. No more setup is required in the Google Cloud Console or elsewhere.

If you prefer to use Custom OAuth2, use the dropdown to change the authentication type.

Custom OAuth2

Managed OAuth2 isn't available for self-hosted n8n users, nor for Google nodes not listed above. You must create a custom OAuth2 single service credential. This means creating an app in the Google Cloud Console and connecting it to n8n with a Client ID and Client Secret.

The rest of this document covers the full process.

Set up Custom OAuth2

There are five steps to connecting your n8n credential to Google services:

1. Create a Google Cloud Console project.
2. Enable APIs.
3. Configure your OAuth consent screen.
4. Create your Google OAuth client credentials.
5. Finish your n8n credential.

Create a Google Cloud Console project

First, create a Google Cloud Console project. If you already have a project, jump to the next section:

--8<-- "_snippets/integrations/builtin/credentials/google/create-google-cloud-project.md"

Enable APIs

With your project created, enable the APIs you'll need access to:

--8<-- "_snippets/integrations/builtin/credentials/google/enable-apis.md"

Configure your OAuth consent screen

If you haven't used OAuth in your Google Cloud project before, you'll need to configure the OAuth consent screen:

1. Access your Google Cloud Console - Library. Make sure you're in the correct project.

   

   Check the project dropdown in the Google Cloud top navigation

2. Open the left navigation menu and go to APIs & Services > OAuth consent screen. Google will redirect you to the Google Auth Platform overview page.
3. Select Get started on the Overview tab to begin configuring OAuth consent.
4. Enter an App name and User support email to include on the Oauth screen. Select Next to continue.
5. For the Audience, select Internal for user access within your organization's Google workspace or External for any user with a Google account. Refer to Google's User type documentation for more information on user types. Select Next to continue.
6. Select the Email addresses Google should use to contact you about changes to your project. Select Next to continue.
7. Read and accept the Google's User Data Policy. Select Continue and then select Create.
8. In the left-hand menu, select Branding.
9. In the Authorized domains section, select Add domain:
   • If you're using n8n's Cloud service, add n8n.cloud
   • If you're self-hosting, add the domain of your n8n instance.
10. Select Save at the bottom of the page.

Create your Google OAuth client credentials

Next, create the OAuth client credentials in Google:

1. Access your Google Cloud Console. Make sure you're in the correct project.
2. In the APIs & Services section, select Credentials.
3. Select + Create credentials > OAuth client ID.
4. In the Application type dropdown, select Web application.
5. Google automatically generates a Name. Update the Name to something you'll recognize in your console.
6. From your n8n credential, copy the OAuth Redirect URL. Paste it into the Authorized redirect URIs in Google Console.
7. Select Create.

Finish your n8n credential

With the Google project and credentials fully configured, finish the n8n credential:

1. From Google's OAuth client created modal, copy the Client ID. Enter this in your n8n credential.
2. From the same Google modal, copy the Client Secret. Enter this in your n8n credential.
3. In n8n, select Sign in with Google to complete your Google authentication.
4. Save your new credentials.

Video

Troubleshooting

Google hasn't verified this app

--8<-- "_snippets/integrations/builtin/credentials/google/unverified-app.md"

Google Cloud app becoming unauthorized

--8<-- "_snippets/integrations/builtin/credentials/google/app-becoming-unauthorized.md"