# Setup Google OAuth App

We have multiple integrations that work with Google such as Google Calender, sheet, etc. To use that integration, the Google OAuth app is required. Here is what you need to do the integration.

### Required Information for Integration

To enable Google integration, you will need the following details:

* **Configuration Name**
* **Google Client ID**
* **Google Client Secret**

### Steps to complete integration <a href="#steps-to-complete-integration" id="steps-to-complete-integration"></a>

### Step 1: Set Up Google OAuth Credentials

1. Navigate to the **Google Cloud Console**.
2. Select an existing project or create a new project.
3. Go to **APIs & Services → Credentials**.
4. Click **Create Credentials → OAuth Client ID**.

{% embed url="<https://console.cloud.google.com/projectselector2/apis/dashboard?pli=1&supportedpurview=project>" %}
Google Developer Console
{% endembed %}

Follow the below official documentation of Google to create the OAuth Credential

{% embed url="<https://support.google.com/cloud/answer/6158849?hl=en#zippy=%2Cuser-consent%2Cpublic-and-internal-applications%2Cauthorized-domains%2Cweb-applications%2Cstep-create-a-new-client-secret>" %}
Setting up Google O-Auth Details
{% endembed %}

#### OAuth Credential Configuration

While creating the OAuth credentials, make sure the following details are used:

* **Credential Type:** OAuth Client ID
* **Application Type:** Web Application
* **Name:** Your Brand Name (e.g. BotPenguin Production)

#### Authorized JavaScript Origins

Add your main application domain:

```
https://app.botpenguin.com
```

#### Authorized Redirect URIs

Add all the following redirect URLs:

```
https://app.botpenguin.com/google-redirect.html
https://app.botpenguin.com/authentication
https://app.botpenguin.com/google-contacts.html
https://app.botpenguin.com/google-sheets.html
https://app.botpenguin.com/google-task.html
https://app.botpenguin.com/google-calendar.html
https://app.botpenguin.com/google-analytics.html
```

After saving, copy the **Google Client ID** and **Google Client Secret**.

***

***

### Step 2: Enable Required APIs & Services

From **APIs & Services → Library**, enable the following APIs:

* Google Sheets API
* Google Tasks API
* Google Calendar API
* People API
* Firebase Cloud Messaging API
* Firebase Installations API

<figure><img src="https://help.botpenguin.com/~gitbook/image?url=https%3A%2F%2F1745791824-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FAPDb8cKQtGlIAfgHjcsQ%252Fuploads%252FCQpLG522pdLjTxIj23Hg%252Fimage.png%3Falt%3Dmedia%26token%3D9021595c-d044-42cc-b8ff-549e7af4ac0e&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=a4ace020&#x26;sv=1" alt=""><figcaption><p>Required APIs</p></figcaption></figure>

***

### Step 4: Save Configuration in BotPenguin&#x20;

1. Log in to the **BotPenguin Agency Panel**.
2. Navigate to partners
3. Navigate to **Integrations → Google**.

<figure><img src="/files/KuM0WYLOw2czh5F7YiA3" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/PcXwOvJVnfa8f3kL4KVP" alt=""><figcaption></figcaption></figure>

4. Click on **Add Configuration** Butto&#x6E;**.**
5. Under **Add Google Integration Details**, fill in:

* **Configuration Name** (any identifiable name)
* **Google Client ID**
* **Google Client Secret**

5. Click **Add Configuration**.

Once saved, the configuration will appear in the list and can be used across Google integrations.

<figure><img src="/files/LKr8TYmm6hWUrNNJNag5" alt=""><figcaption></figcaption></figure>

***

### Step 5: Get the OAuth Consent Screen Verified

After completing the above steps:

1. Add a **developer/test account** in the Google Cloud Console.
2. Create **demo videos** explaining how Google integrations are used.
3. Submit the OAuth consent screen for verification.

***

### Required Scopes for OAuth Approval

#### Non-Sensitive Scopes

```
/auth/calendar.settings.readonly
/auth/drive.file
/auth/userinfo.profile
```

#### Sensitive Scopes

```
/auth/calendar
/auth/calendar.events
/auth/spreadsheets
/auth/spreadsheets.readonly
/auth/tasks
/auth/tasks.readonly
```

#### Restricted Scopes

```
None
```

***

### Completion

Once the OAuth consent screen is approved, all Google-based integrations (Calendar, Sheets, Tasks, Contacts, Analytics) will work seamlessly.

#### Need Help?

Please feel free to reach out to us at <mark style="color:$primary;"><support@botpenguin.com></mark>, in case of any questions or concerns.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://partners.botpenguin.com/partner-platform-guidelines/integration-setup/setup-google-oauth-app.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.