Google Calendar Integration
Connect Google Calendar to automatically create and manage booking events
Prerequisites
- • Google account with Google Calendar access
- • Calendar where you want bookings to appear
- • Service account email (provided below)
- • Completed Google Sheets setup (recommended)
Service Account Email
widget-b@secure-bongo-472822-d7.iam.gserviceaccount.comKeep this email handy - you'll need it in Step 2
1Access Your Calendar Settings
- 1
Go to Google Calendar
- 2
On the left sidebar, find My calendars
This shows all calendars you own
- 3
Hover over the calendar you want to use for bookings
We recommend using your primary calendar or creating a dedicated "Bookings" calendar
- 4
Click the three dots menu (⋮)
that appears
- 5
Select Settings and sharing
2Share Calendar with Service Account
In the calendar settings page:
- 1
Scroll down to Share with specific people or groups
This is in the "Settings for my calendars" section
- 2
Click + Add people and groups
- 3
Enter the service account email:
widget-b@secure-bongo-472822-d7.iam.gserviceaccount.com - 4
Set permissions to Make changes to events
This permission level is required for the widget to create and manage bookings
- 5
Click Send
The service account will now have access to your calendar
3Note Your Calendar Email
You'll need to know which email address is associated with this calendar:
Your Calendar Email
This is typically your Gmail address (e.g., yourname@gmail.com)
If using a workspace account, it might be yourname@company.com
You'll enter this email in your widget configuration to specify which calendar to use for bookings
4Configure Your Booking Widget
- 1
Log in to your Widgetfied Dashboard
- 2
Find the Booking Widget card
- 3
Click the Configuration button
- 4
Locate the Email Settings section
- 5
Find the Calendar Email field
- 6
Enter your calendar email address (from Step 3)
This tells the widget which calendar to use for bookings
- 7
Click Save to apply changes
Verify Your Setup
Test your calendar integration:
Create a test booking through your widget
A calendar event should appear immediately in your Google Calendar
Check the calendar event details
It should include customer name, service, and booking time
Verify two-way sync (if enabled)
Changes in the calendar should reflect in your dashboard
Troubleshooting
Events not appearing in calendar
- • Verify service account has "Make changes to events" permission
- • Check that the calendar email in widget settings matches your Google Calendar
- • Ensure the calendar is not in trash or archived
- • Try refreshing your Google Calendar page
Permission errors
- • Service account needs "Make changes to events" not just "See all event details"
- • If using Google Workspace, admin permissions might be required
- • Calendar must be owned by you (not subscribed or shared read-only)
Wrong calendar being used
- • Double-check the email address in widget configuration
- • If you have multiple calendars, ensure you shared the correct one
- • The calendar email should match the one you see in Google Calendar settings
Best Practices
Dedicated Booking Calendar
Consider creating a separate "Bookings" calendar to keep customer appointments organized
Team Access
Share the booking calendar with your team so everyone can see scheduled appointments
Calendar Settings
Set up working hours and busy times in Google Calendar to prevent double-booking
Notifications
Enable calendar notifications to get alerts for new bookings and reminders
Setup Complete! 🎉
Your Google Calendar is now connected. Bookings will automatically appear as calendar events.