# Google Sheets

## Overview

You can create a Google Sheets Destination Connector to write to a single Google Sheet using your Google account.

To set up this Destination Connector, your Google account will need access to the Google Sheet you are connecting to.

The schema for this Destination Connector is defined by the first row of the Google Sheet, so column header names must be provided.

{% hint style="info" %}
If you have multi-factor authentication enabled for your Google account, you may need to recreate the Destination Connector when the authentication expires. Re-authentication for existing connectors is coming soon.
{% endhint %}

## **Prerequisites**

Required information:

1. Google Sheet URL
2. Spreadsheet Sheet Name
3. Google Account Username & Password

## Creating a Google Sheets Destination Connector

**Step 1:** After selecting **+ New Connector**, under the **System** prompt, click **Google Sheets**

![](https://353417064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYrsDW6vGBTygB1qqSE%2Fuploads%2FiHVzJZBgdy5HNVIJOxq4%2FGoogle%20Sheets.png?alt=media\&token=78336e03-1a6e-4fce-b533-e0b059dd29a9)

**Step 2:** Provide a **Connector Name.**

**Step 3:** Select **Destination Connector.**

**Step 4:** Provide the entire URL for the spreadsheet you want to connect to in the **Spreadsheet URL** field. 

{% hint style="info" %}
**Note:** the schema for this Destination Connector is defined by the first row of the Google Sheet, so **column header names must be provided**.
{% endhint %}

![](https://353417064-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYrsDW6vGBTygB1qqSE%2F-MZEhWxlamfhJwNv6sQK%2F-MZEjg2t9j09aJxy032g%2Fimage.png?alt=media\&token=d1d078ad-c796-4148-b6fd-25a6d6435b19)

**Step 5:** Provide the **Spreadsheet** **Sheet Name** as shown below.

![](https://353417064-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYrsDW6vGBTygB1qqSE%2F-Ma4z0_qGzJmuDluKI30%2F-Ma57Qi2__bMKgX4sZc6%2Fimage.png?alt=media\&token=907760d0-db16-4e09-bce3-61f8ddcc17da)

**Step 6:** Select an **Update Method** to determine what will happen when data is written to a sheet that already contains some data:

* **Append**, which is the default, will place any new records at the bottom of the sheet after any existing data.
* **Overwrite** will clear all the data in the sheet before each write.

### Advanced Options

#### Validation Webhook

We support the use of Validation Webhooks to prevent bad data from being written to your systems, adding another layer of protection to the built-in validations that Osmos provides. The Webhook URL can be posted here.

{% hint style="info" %}
For more information on Validation Webhook configuration, see [Server Side Validation Webhooks](https://docs.osmos.io/developer-docs/validation-and-transformation-webhooks)
{% endhint %}

## Connector Options

The connector can be deleted, edited and duplicated.

Duplication

To save time, the connector can be duplicated.  This new connector needs to be named and can be edited, as needed.

<figure><img src="https://353417064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYrsDW6vGBTygB1qqSE%2Fuploads%2F0sMTk5khAZbS3jBBchvF%2FCleanShot%202024-01-04%20at%2020.53.21%402x.png?alt=media&#x26;token=a5603f86-4b08-402c-90bb-21c72bc9c262" alt="" width="563"><figcaption></figcaption></figure>