1. Keragon
  2. Connectors
  3. Gmail

Gmail

Updated

This page contains the setup guide and reference information for the Gmail connector.

Prerequisites

Before connecting your Gmail account, ensure that:

  • You have access to a Google Cloud Platform account.

Setup Guide

Follow these steps to set up OAuth credentials for Gmail and connect your account to Keragon:

00:00: This guide will walk you through creating a Google auth client for Gmail in 00:04: a structured Manner and use the credentials created on tarragon dashboard. 00:09: First visit the console.cloud.google.com page 00:14: Go to Google developer console Cloud resource manager and start 00:18: by creating a new project. 00:21: Enter your desired project name. For example tarragon Gmail project. 00:27: Proceed by clicking the create button 00:30: Select the newly created project. 00:33: Click the menu icon at the top left. 00:36: Access the enabled apis and services section. 00:40: Look for resources docs and products. 00:44: Enter Gmail API in the search bar and select it from the search results. 00:49: Enable the Gmail API 00:52: Go back to the enabled apis dashboard. 00:55: Access the oauth consent screen settings 00:58: Select the internal option under user type 01:01: Click create 01:04: Proceed by selecting and filling in the app name field. 01:06: For example caragon Gmail app 01:10: Select the email address from the drop-down. 01:13: Sent an email address under developer contact information. 01:17: Save and proceed to the next step. 01:20: Access the option to add or remove scopes. 01:23: In the filter search for Gmail API. 01:27: Enable all Scopes by clicking the highlighted checkbox 01:31: Click the update button. 01:34: Save and move on to the next step. 01:37: Return to the main dashboard 01:40: Access the credentials section 01:43: Initiate the creation of new credentials 01:46: Select the oauth client ID option 01:49: Click the application type field. 01:52: Select the web application type 01:55: Add new Urus under authorized redirect Uris. 02:00: Add a nouri. 02:03: Add the URI to the list and add another one. 02:06: Enter the second worry here. 02:09: Create the credentials. 02:12: Copy the client ID and secret and paste them into your tarragon Gmail Authentication. 02:18: You are now set up to authenticate Gmail on caragon dashboard and start 02:22: building your hippie. AA compliant workflow.

  1. Go to console.cloud.google.com.

  2. Click Create Project and enter a name, such as "Keragon Gmail Project".

  3. Click Create, then Select Project once it's created.

  4. Open the menu icon and go to Enabled APIs & Services.

  5. Use the Search field to find and select Gmail API.

  6. Click Enable to activate the Gmail API.

  7. Go back to the dashboard and click OAuth consent screen.

  8. Choose Internal for User Type and click Create.

  9. Fill in the following:

    • App name (e.g., "Keragon Gmail App")

    • User support email

    • Developer contact email

  10. Click Save and continue.

  11. On the Scopes page, click Add or remove scopes, search for Gmail API, select all necessary scopes, then click Update and Save and continue.

  12. Return to the main dashboard and go to Credentials.

  13. Click Create credentials > OAuth client ID.

  14. For Application type, choose Web application.

  15. Add the following URIs under Authorized redirect URIs:

    • https://api.us-east-1.keragon.com/rest/auth/callback

    • https://api.us-1.keragon.com/rest/auth/callback

  16. Click Create.

  17. Copy the Client ID and Client Secret.

  18. Go to app.keragon.com and open the Gmail connector setup.

  19. Paste the Client ID and Client Secret into the respective fields.

  20. Click Connect to complete the integration.

Need more help connecting?

Check the fully extended Gmail connector setup guide for screenshots, detailed steps, and additional context.

Once set up, Keragon can authenticate and securely interact with your Gmail account using OAuth 2.0.

Troubleshooting and Common Errors

Error Message Cause Suggested Fix
redirect_uri_mismatch Redirect URIs not configured correctly in Google Cloud Ensure both Keragon URIs are added exactly to the OAuth client settings.
invalid_client Client ID or Secret is incorrect Confirm you copied them from the correct credentials page.
access_denied User denied access or consent screen issue Retry the OAuth flow and approve all requested permissions.
403 Forbidden Missing required Gmail API scopes Recheck and update the scopes in the OAuth consent screen.

Limitations and Notes

  • Authentication is handled using OAuth 2.0 with a custom Google Cloud application.

  • Both redirect URIs must be added during credential setup to ensure successful authentication.

  • Only Gmail accounts with proper permissions and API access can be used.

Was this article helpful?
0 out of 0 found this helpful

Articles in this section