---
description: Configuration details for the Google Sheets integration.
---

# Google Sheets

## Overview

Via the Google Sheets integration, Hightouch can sync your spreadsheets with your data sources.

This allows you to:

1. Share data in an easily accessible way across teams
2. Work with your data with familiar spreadsheet tools

Hightouch allows you to connect to Google Sheets in two ways:

* **User OAuth**: The User OAuth authentication method allows Hightouch edit access to any Google Sheet your user has access to. This is for organizations that do not allow users from other domains to be added to a Google Sheet.
* **Service Account**: The Service Account authentication method provides fine-grained control over access to your data. You add a unique Hightouch service account as an editor user to specific sheets that you want to sync.

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MZyjakMpCwO8SqVXOM8%2F-MZykWY1An4BW-VoaBGy%2Fimage.png?alt=media\&token=a2967a3f-dcd9-40da-8b4d-775488fcbfb3)

## Initial Setup via OAuth

Select the **Google Sheets** destination option. Hightouch will prompt you to authorize our app with your Google account with the following scopes:

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MZyjakMpCwO8SqVXOM8%2F-MZykoGywH0OB1oxhlTz%2Fimage.png?alt=media\&token=f5ceaa84-d56d-463b-8da8-f4701145835a)

After authorizing, you will have successfully connected Hightouch to Google Sheets.

## Initial Setup via Service Account

Setting up the Google Sheets destination via the service account method allows you to limit what files Hightouch can access, instead of allowing access to all of a user's files.

Select the **Google Sheets (Service Account)** destination option. Then, after successfully generating the service account, make note of the service account email.

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MZyiW-iixvd2UNLrt0G%2F-MZyj6bL8tlSndLV51V3%2Fimage.png?alt=media\&token=b7c47dbd-7cd0-45ae-99fa-79f260823c74)

To give Hightouch access to a certain spreadsheet, share the spreadsheet with the service account email with the "Editor" permissions.

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MZyiW-iixvd2UNLrt0G%2F-MZyjOerSMBbYmDwL75l%2Fimage.png?alt=media\&token=c8bfa856-72e0-4c79-a981-e96dc5b2ac29)

You're all set! You'll be able to sync directly to the spreadsheets while keeping the rest of your data private.

## Syncing Data to Sheets

The Google Sheets destination allows you to mirror your data to a spreadsheet. Hightouch does this by overwriting the entire contents of the selected sheet. Note: please ensure that you have no other data that is not intended to be overwritten on the sheet.

### Sheet Configuration

In Hightouch, select the name of the spreadsheet that you would like to sync to. If you don't see your spreadsheet here, make sure you authorized the right account or invited the Hightouch service account email to your spreadsheet, depending on your setup mode.

Select the sheet within the spreadsheet that you would like to sync to. For Google Sheets, Hightouch deletes all the contents of the spreadsheet and writes your entire query result into the spreadsheet for every sync.

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-MZyjakMpCwO8SqVXOM8%2F-MZylO9M8LReiJVlH-pQ%2Fimage.png?alt=media\&token=70ebc363-3f79-4ad4-a959-681e17d4b6e1)

### Data Format

Google Sheets accepts inputted data in two ways, raw or user entered.

* **Raw:** The values the user has entered will not be parsed and will be stored as-is. Keep in mind that Hightouch does some casting so numbers and dates may be sent as strings.
* **User Entered:** The values will be parsed as if the user typed them into the UI. Numbers will stay as numbers, but strings may be converted to numbers, dates, etc. following the same rules that are applied when entering text into a cell via the Google Sheets UI.

![](https://1454996985-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MHsth_4gateO06TTdt4%2F-M_gTflJRqGN6tWjvnbT%2F-M_gU25jGlobq4XMzzK_%2Fimage.png?alt=media\&token=cc95ccb4-ccbc-4d1c-9602-1e635d568cfc)

For more information, read the [Google documentation](https://developers.google.com/sheets/api/reference/rest/v4/ValueInputOption).

