# Google Workspace authentication

> To create a connection, you need the following credentials:

## Prerequisites

To create a connection, you need the following credentials:

* Client ID
* Client secret
* OAuth Scope

You must create your own OAuth 2.0 application to create a connection. To learn how to create an OAuth 2.0 app, refer to the
[Google documentation](https://developers.google.com/identity/protocols/oauth2) and [Set up OAuth applications in Google Cloud](https://docs.uipath.com/activities/other/latest/productivity/set-up-applications-in-google-cloud).

:::note
When registering your OAuth application in Google, make sure to set the [callback URL](connections#callback-url) to the value displayed on the connection creation page, for example `https://cloud.uipath.com/provisioning_/callback` for Automation Cloud.
:::

## Scopes

The following default scopes are configured for the Google Workspace connector: `openid`, `https://www.googleapis.com/auth/userinfo.email`, `https://www.googleapis.com/auth/userinfo.profile`, `https://mail.google.com/`, `https://www.googleapis.com/auth/calendar`, `https://www.googleapis.com/auth/gmail.settings.basic`, `https://www.googleapis.com/auth/drive`, `https://www.googleapis.com/auth/drive.labels.readonly`

## Add the Google Workspace connection

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the **Connections** tab.
3. Select **Add connection**.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. Enter the required credentials: Client ID and Client secret.

   For any secret-type field, you can select the menu next to the field and choose **Use credential asset** to reference an Orchestrator credential asset linked to an external vault instead of entering the value directly. For more information, see [Use credential assets for connections](credential-store-connections.md).
6. Fill in the **OAuth Scope** field with the scopes you need.
7. Select **Connect**.
