Google Sheets
Google Sheets Integration Guide
Learn how to connect your CRM with Google Sheets to automatically export leads, sync data, and import records using the Google Cloud Console.
Overview
The Google Sheets integration allows your CRM to seamlessly push and pull data from Google Spreadsheets in real time.
What You Can Do
- Auto-Export Leads: Automatically send newly captured leads (from Web, Facebook, Instagram) directly into a specified Google Sheet.
- Data Sync: Keep CRM records and Google Sheet rows in sync when updates occur.
- Bulk Import: Easily map columns and import massive lists of contacts from a Google Sheet into the CRM.
- Reporting: Send CRM metrics and pipeline data to Sheets for custom dashboard building in Google Looker Studio.
Prerequisites
Google Cloud Console Setup
Create a project and enable the necessary APIs for Google Sheets and Drive.
1
Create a New Project
- Go to the Google Cloud Console.
- In the top navbar, click the Project Dropdown (next to the Google Cloud logo).
- Click New Project.
- Name your project (e.g., "DELYNTRO Integration") and click Create.
- Wait a moment, then make sure you have selected your newly created project from the dropdown.
2
Enable Google Sheets API
- In the left sidebar, navigate to APIs & Services → Library.
- Search for "Google Sheets API".
- Click on the result and click the blue Enable button.
3
Enable Google Drive API
- Go back to the API Library.
- Search for "Google Drive API" (This is required for the CRM to find and list the user's available spreadsheets).
- Click on the result and click Enable.
Generate OAuth Credentials
Configure the consent screen and generate the keys that will let the CRM talk to Google.
1
Configure OAuth Consent Screen
- Go to APIs & Services → OAuth consent screen.
- Choose External (if your CRM users have personal Gmails) or Internal (if strictly using Google Workspace within your org). Click Create.
- Fill in the App name (e.g., DELYNTRO), User support email, and Developer contact information.
- Click Save and Continue. You do not need to add specific scopes here unless requested. Skip through Scopes and Test Users by clicking Save and Continue.
- Click Back to Dashboard.
App Status: If you select "External", your app will be in "Testing" status. While in testing, you must manually add the email addresses of any users who want to connect their Google accounts under the "Test users" section. To remove this limit, you must click Publish App (which may require Google verification).
2
Create OAuth Client ID
- Go to APIs & Services → Credentials.
- Click + Create Credentials and select OAuth client ID.
- For Application type, select Web application.
- Name it (e.g., "CRM Web Client").
- Under Authorized redirect URIs, click + Add URI.
- Enter the exact redirect URL provided by your CRM (Usually found in Admin Settings → Google Sheets). Example:
https://yourdomain.com/google_auth/callback - Click Create.
3
Copy Your Keys
A modal will appear containing your Client ID and Client Secret. Keep this tab open or copy these values somewhere safe; you will need to paste them into the CRM.
CRM Admin Configuration
1
Save Credentials in CRM
- Log in to your CRM as an Administrator.
- Navigate to Settings → Integrations → Google Sheets.
- Paste your Client ID and Client Secret into the respective fields.
- Click Save Settings.
2
User Account Connection
Once the admin has saved the API keys, individual users or tenants can connect their own Google accounts.
- Users go to My Integrations → Google Sheets.
- Click Connect Google Account.
- They will be redirected to Google to choose their account and grant permission for the CRM to "See, edit, create, and delete all your Google Sheets spreadsheets".
- Once granted, they are redirected back to the CRM and the connection is active.
Usage & Field Mapping
1
Auto-Export New Leads to Sheets
To automatically push new leads to a spreadsheet:
- Create a new blank Google Sheet in your Drive.
- In the first row (the header row), add column names like Name, Email, Phone, Source, Date.
- In the CRM, go to Lead Automations → Google Sheets Export.
- Select your connected Google Account, then choose the spreadsheet you just created from the dropdown.
- Select the Worksheet tab (usually "Sheet1").
- The CRM will load your spreadsheet columns. Map the CRM fields (e.g., Lead Name, Email) to your Sheet columns.
- Enable the automation. All future leads will append a new row to this sheet instantly.
Troubleshooting
| Problem | Possible Reason | Solution |
|---|---|---|
| "Error 400: redirect_uri_mismatch" | The redirect URI in GCP does not exactly match the one the CRM is using. | Check for trailing slashes, http vs https, or www. Update the GCP Authorized Redirect URI to match exactly. |
| "Error 403: access_denied" | Your app is in "Testing" mode and the user is not a Test User. | Add the user's email to the "Test users" list in the OAuth Consent Screen settings, or Publish the app. |
| Cannot see my spreadsheets in CRM dropdown | Google Drive API is not enabled. | Go to GCP Console and ensure both Sheets API and Drive API are enabled. |
| Data is not exporting to Sheets | Header row missing or changed. | Ensure the first row of your Google Sheet has column headers and they haven't been renamed after mapping. |
| Token Expired / Disconnected | User changed password or revoked access. | Have the user go to Integrations and click "Reconnect" to generate a fresh token. |