HELP / INTEGRATIONS / GOOGLE CALENDAR

Share your Google Calendar

Admin4 min read

Last verified 2026-09-17

Connect your Google Calendar by sharing it with ValueRamp's read-only service account to record meeting cadences and attendance without OAuth credentials.

Before you start

  • ValueRamp account
  • Google Workspace work account with calendar sharing rights

Connecting Google Calendar enables ValueRamp to maintain an accurate, objective record of customer engagement cadence, executive sponsor attendance, and meeting momentum alongside Fathom call recordings and customer email threads.

Google Calendar is configured per user in Settings → My Connections (/my-integrations). Because calendar connections are per-user, each teammate connects their own work calendar to correlate their personal appointments with customer account records.

The Zero-OAuth Sharing Model

Rather than requesting wide OAuth scopes that grant full mailbox access, ValueRamp connects to Google Calendar via a dedicated, read-only Google Cloud service account:

  1. You grant ValueRamp's service account read access to your specific primary work calendar.
  2. ValueRamp queries only that calendar for meetings containing customer attendees.
  3. You can revoke access at any time directly in Google Calendar without revoking other workspace integrations.

Step-by-Step Setup Guide

To connect your Google Calendar:

  1. Navigate to My Connections (/my-integrations).
  2. Scroll to the Calendar card and confirm the Google Calendar tab is active.
  3. In Step 1, copy the service account address:
    valueramp-calendar@valueramp-calendar.iam.gserviceaccount.com
    
  4. In a new browser tab, open Google Calendar:
    • In the left sidebar, find My calendars and hover over your primary work calendar.
    • Click the three dots (options) and select Settings and sharing.
    • Scroll down to the Share with specific people or groups section and click Add people and groups.
    • Paste the copied service account email address.
    • Set permissions to See all event details (do not select "See only free/busy").
    • Click Send.
  5. Return to ValueRamp and navigate to Step 2:
    • Enter your Calendar ID (for primary work calendars, this is simply your corporate email address, e.g. you@yourcompany.com).
    • Click Connect calendar.
  6. ValueRamp initiates a synchronization check against Google's API. Once verified, the status indicator turns green (Connected).

Permission States and Troubleshooting

  • Connected: The service account can read event titles, times, and attendees. Syncing operates automatically in the background.
  • Limited access: If you selected "See only free/busy" during Google Calendar sharing, ValueRamp can see that a meeting occurred but cannot identify which customer attended. To resolve, edit the service account permission in Google Calendar to See all event details.
  • Action needed / Errored: Indicates Google's API returned an authentication error, typically because the calendar has not yet been shared with the service account or the Calendar ID was mistyped.

Privacy Guarantees

ValueRamp adheres to strict data minimization for calendar synchronization:

  • Metadata only: We read meeting title, start/end time, and participant email addresses.
  • No descriptions: Event descriptions, agenda notes, and meeting attachments are never fetched or stored.
  • Customer domain matching: Only meetings where at least one external attendee matches an active account domain in your ValueRamp workspace are ingested.
  • No AI access: Calendar events are used strictly for cadence metrics and timeline logging; no AI models process calendar data.
The Calendar integration card on My Connections with Google Calendar tab selected

1 / 4Select Google Calendar under My Connections

Steps

  1. Select Google Calendar under My Connections

    The Calendar integration card on My Connections with Google Calendar tab selected
  2. Share your calendar with ValueRamp's service account

    Google Calendar service account address and step-by-step sharing instructions
  3. Enter your Calendar ID and connect

    Calendar ID input field with placeholder and Connect calendar button
  4. Verify privacy safeguards that restrict data to titles, times, and attendees

    Privacy block explaining that only event titles, times, and attendees are read, while descriptions are ignored

Common questions

Why does ValueRamp use a service account rather than Google OAuth?

Using a dedicated service account (valueramp-calendar@valueramp-calendar.iam.gserviceaccount.com) avoids broad OAuth consent scopes. You explicitly share only the specific calendar you want ValueRamp to read, and you can revoke access anytime in Google Calendar settings.

What permission level should I choose in Google Calendar?

You must choose 'See all event details'. If you select 'See only free/busy', ValueRamp cannot read event titles or attendee email addresses to match meetings to customer accounts, causing the connection to enter a 'Limited access' state.

Does ValueRamp read event descriptions or private notes?

No. ValueRamp only ingests meeting titles, start/end timestamps, and attendee email lists. Event descriptions, agenda attachments, meeting links, and private notes are never read or stored.

What happens to internal team meetings that do not include customers?

ValueRamp checks attendee email domains against your active Accounts roster. Meetings where all attendees belong to your own company domain, or where no external customer is present, are immediately dropped and never recorded on any account.

Was this helpful? Tell us what was missing