# Google Calendar

### Summary

Boomerang integrates with Google Workspace calendars to analyze meeting history across your organization. By connecting via a Google Service Account with Domain-Wide Delegation, Boomerang can securely read calendar events, users, and group data — without requiring individual logins from each team member.

This meeting data is one of the key signals Boomerang uses to determine relationship strength between your team members and prospects. The more meetings a person has had with a prospect in the past, the stronger their relationship score — helping Boomerang surface the best introduction path for your sales reps.

The setup involves two parts: authorizing Boomerang in your Google Admin Console, and configuring your account on the Boomerang platform.

***

### Understanding the Key Concepts

#### What is a Service Account?

A Service Account is a special type of Google account designed for server-to-server integrations. It allows applications like Boomerang to access Google Workspace data securely and automatically, without requiring individual user sign-ins.

#### What is Domain-Wide Delegation?

Domain-Wide Delegation allows a Service Account to access data on behalf of users across your Google Workspace domain. Boomerang uses this to read calendar events, user directories, and group memberships — using **read-only** scopes to ensure no data is modified.

> Boomerang only requests the minimum permissions needed: viewing calendar events, users, and groups. No data is written or altered.

***

### Setup Guide

#### Part 1: Enable Domain-Wide Delegation in Google Admin Console

**1.** Go to the [Google Admin Console](https://admin.google.com/).<br>

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

**2.** Navigate to **Security → API Controls**.<br>

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

**3.** Click **Manage Domain-Wide Delegation**.<br>

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

**4.** Click **Add new**.<br>

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

**5.** Enter the Boomerang Discover Client ID:

```
112427182534349608190
```

**6.** Add the following OAuth scopes (comma-delimited) and click **Authorise.**

```
https://www.googleapis.com/auth/calendar.readonly,https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/admin.directory.group.member.readonly
```

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

**7.** Confirm the newly added service account appears in the list under **API Clients**.<br>

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

***

#### Part 2: Connect Your Admin Account on Boomerang

**1.** Go to app.getboomerang.ai and log in to your account.&#x20;

In the bottom left corner, click on **Workspace Settings**. Navigate to **Integration.** You will see all available integrations listed here.<br>

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

**2.** Select **Google Calendar** and click **Connect.**<br>

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

**3.** Enter your **Google Workspace admin email address** and click **Connect.**<br>

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

**4.** You should see a **"Connection setup successful"** confirmation message.

***

### Best Practices

**Use a Super Admin account for the connection.** When entering the admin email in Boomerang, use a Google Workspace Super Admin account to ensure uninterrupted access. If the account's permissions change or the user leaves the organization, the integration may break.

**Verify the Client ID before authorizing.** Double-check that the Client ID entered during Domain-Wide Delegation setup matches exactly — an incorrect ID will result in a failed or incomplete integration.

***

### All Done!

Once setup is complete, Boomerang will begin analyzing meeting history for your selected teams. This data, combined with other relationship signals, will help surface your organization's strongest connections to any prospect — enabling warmer, more effective introductions for your sales reps.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://help.getboomerang.ai/integrations/calendar-integrations/google-calendar.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.