Skip to main content

​
What this credential is for

Use Google OAuth Credential for Google-integrated nodes such as:

​
Create project and OAuth client in Google Cloud

1

Open Google Cloud Console

Go to Google Cloud Console and sign in with the Google account you want to connect.
2

Create or select a project

In Google Cloud Console > Project selector, choose an existing project or click New Project. Create it, then confirm it is selected in the top bar before continuing.
3

Configure OAuth consent screen

Go to APIs & Services > OAuth consent screen. For most personal accounts, you would want to choose External.Fill required fields:
  • App name
  • User support email
  • Developer contact email
Save and continue through defaults.
If publishing status is Testing, add your Google account under Test users or login/consent may fail.
4

Enable the APIs you need

Go to APIs & Services > Library and enable only the APIs required by your graph.Common examples:
  • Google Calendar API for Calendar nodes.
  • Gmail API for Gmail nodes.
  • Google Sheets API for Sheets nodes.
  • Google Docs API for Docs nodes.
5

Create OAuth client credentials

Go to APIs & Services > Credentials and click Create Credentials > OAuth client ID. Choose the application type that matches your connector/tool:
  • Web application: most common for hosted connectors/tools.
Add this exact Authorized redirect URI:
https://staging-api.relai.ai/api/v1/credentials/google-oauth/callback/
The redirect URI must match exactly (including path and trailing slash rules) or OAuth will fail.
After creation, copy the generated Client ID and Client Secret. You will need these to create the credential in RELAI in the next step.

​
Create the credential in RELAI

Add Google OAuth Credential form with redirect URL, client ID, client secret, and permissions selection
1

Open credentials in RELAI

Go to the Credentials page. This credential can be created by clicking Create new credential > Create Google OAuth Credential.
2

Fill in form details and create

In the Add Google OAuth Credential form:
  • Enter a credential name.
  • Enter your Google OAuth Client ID.
  • Enter your Google OAuth Client Secret.
  • Select which Google permissions to request.
Then click Create, complete authorization, and select this credential in any node that requires a Google OAuth Credential.

​
Scope guidance

Include the required scopes for your workflow. If one credential is shared by multiple Google nodes, include the union of required scopes.
Use caseTypical scope(s)
Google Sheets accesshttps://www.googleapis.com/auth/spreadsheets
Google Docs accesshttps://www.googleapis.com/auth/documents
Google Drive file accesshttps://www.googleapis.com/auth/drive
Google Slides accesshttps://www.googleapis.com/auth/presentations
Google Calendar accesshttps://www.googleapis.com/auth/calendar
Gmail accesshttps://mail.google.com/
If required APIs are disabled or scopes are missing, Google nodes fail with authorization or permission errors.

​
Quick troubleshooting checklist

  • Confirm the correct GCP project is selected when creating OAuth credentials.
  • Verify all required APIs are enabled in APIs & Services > Library.
  • If app status is Testing, ensure your Google account is added as a test user.
  • Recheck that the redirect URI configured in GCP exactly matches the URI shown by your connector/tool.
  • Ensure scopes in the credential include every Google service your graph uses.