Google Calendar Actions

Google Calendar actions let you automatically book, cancel, and check availability for calendar events based on call outcomes. This is ideal for scheduling follow-up meetings, consultations, or appointments directly from your AI call workflows.

Prerequisites

Before using Google Calendar actions, connect your Google account:

Go to Integrations in the sidebar
Find Google Calendar and click Connect
Sign in with your Google account and authorize BuildVoiceAI to manage your calendar

The OAuth connection grants BuildVoiceAI permission to create, update, and delete events on your behalf.

Available Actions

book_event

Creates a new event on your Google Calendar.

Config Field	Required	Description
Calendar	Yes	Which Google Calendar to create the event on
Title	Yes	Event title. Supports template variables (e.g., `Follow-up: \{\{caller_name\}\}`)
Duration	Yes	Event length in minutes (e.g., 30, 60)
Attendee email	No	Email address to add as an attendee. Can use call metadata if available

The event is created at the next available time slot based on your calendar availability. The event description automatically includes the call summary and a link to the call details.

💡

Use the \{\{caller_name\}\} variable in the title so you can easily identify which call the appointment relates to when looking at your calendar.

cancel_event

Cancels an existing calendar event associated with the contact.

Config Field	Description
(none)	Cancels the most recent upcoming event matching the contact

The event is identified by matching the attendee email or the event metadata linking it to the contact. Cancelled events are removed from the calendar and attendees are notified.

check_availability

Checks your calendar for available time slots.

Config Field	Description
Calendar	Which calendar to check
Date range	The period to check for availability

This action is primarily used internally by the book_event action to find an open slot, but can also be useful in workflows that need to verify availability before taking other actions.

Calendar Selection

If your Google account has multiple calendars, you can choose which one to use for each action. This lets you:

Book client calls on a dedicated “Client Meetings” calendar
Use different calendars for different agents or clients
Keep AI-booked appointments separate from your personal calendar

Event Details

When book_event creates an event, it automatically includes:

Title — Your configured title with template variables resolved
Duration — The configured event length
Description — Call summary, agent name, call duration, and sentiment
Attendee — The configured attendee email (if provided)

Template Variables

The title and other text fields support all standard template variables:

Variable	Example
`\{\{caller_name\}\}`	John Smith
`\{\{phone_number\}\}`	+14155551234
`\{\{summary\}\}`	Discussed premium plan pricing
`\{\{sentiment\}\}`	positive
`\{\{agent_name\}\}`	Sales Agent

Example Workflow

A qualification-to-booking workflow:

Condition: sentiment equals positive AND call_duration greater than 120
upsert_contact (GHL or HubSpot) — Ensure contact exists
book_event — Schedule a follow-up meeting titled “Follow-up: {{caller_name}}”
Email — Send confirmation email to the caller
Slack — Notify the sales team about the new appointment

Google Calendar OAuth tokens refresh automatically. If you see authentication errors, go to Integrations and reconnect your Google account.