Setting up a Sync
TL;DR: A sync keeps one Google calendar and one monday board connected — when something changes on one side, the other updates based on the sync direction you choose. This page walks you through the full setup: authorizing the app, connecting your Google account, and configuring the sync wizard.
Before you start
- The app is installed and added to your board — see Installation & Authentication if you haven't done this yet
- Your board has the right columns for syncing — see Board Setup Best Practices
- You have a Google account with access to Google Calendar
Authorize with monday.com
Before connecting to Google Calendar, you first need to authorize the app to access your monday.com account.
Review the permissions — the app needs access to read and write your board data (items, columns, subitems) to keep them in sync
Click Authorize
This is a one-time step. Once authorized, you won't be asked again unless you revoke access.
Connect your Google account
1. Start authentication
When you first add the app, you'll be prompted to connect your Google account.
Click Connect to Google Calendar
You'll be redirected to Google's login page
2. Sign in to Google
Enter your Google account credentials
If you have multiple accounts, select the one with your Google Calendar
3. Authorize permissions
Review the permissions the app is requesting, click Accept to grant access.
Choose Personal or Team sync
After connecting your Google account, you'll see a screen asking "What do you need syncing?" — this is where you choose between two sync modes:
- Personal sync — sync this board with your own Google Calendar. You connect one calendar, and it syncs to one board. Best for managing your own tasks and deadlines.
- Team sync (Recommended) — each assignee on your board automatically syncs items to their own calendar. One setup manages all team members' calendars based on the People column. Built for teams. Requires the Advanced plan or higher — on other plans, choose Personal sync.
A board can have Personal syncs or a Team sync, not both. To switch a board to Team later, delete its Personal sync first.
Not sure which to pick? Start with Personal sync if you're the only one using the board. Choose Team sync if multiple people need their own calendar events from the same board. For a full comparison, see Personal vs. Team .
Click Continue to enter the sync wizard.
The sync wizard
The wizard has 4 steps: Sync scope, Field mapping, Incoming data and Outgoing data. Sections 1–3 and the optional settings below are all on the Sync scope screen.
1. Select your calendar
After authentication, the sync configuration panel opens, choose which calendar to sync:
Your calendars will be listed
Select the specific calendar you want to use
Unlike the native monday.com integration, you can choose any calendar, not just your primary one.
2. Choose sync direction
Google Calendar → monday
Two-way sync
Changes and creations sync in both directions
3. Choose items or subitems
On the right side, select what you want to sync with Google Calendar:
Items
Sync parent-level items from your board
Subitems
Sync subitems instead of parent items
Optional settings
At the bottom of the sync scope screen, you'll find two optional checkboxes. Both are off by default.
☐ Sync deletions in both directions When an item or event is deleted on either side, the corresponding record on the other side is automatically deleted too.
Be careful — this is permanent. If someone deletes an item by mistake, the calendar event is also gone.
Be careful — this is permanent. If someone deletes an item by mistake, the calendar event is also gone.☐ Create as Google Meet Automatically adds a Google Meet link to new events created from monday.
Looking to import past or future events? This isn't part of the wizard. After your sync is activated, go to the Import Existing Events tab in the admin panel. See Import Existing Events for details.
Field mapping
Field mapping determines how data translates between monday.com columns and Google Calendar event fields. This section covers the basics — for the full reference, see Field Mapping .
💡 For the best results, set up your board following our Board Setup Best Practices before configuring mapping.
How it works
- Map your Date column → Event shows on that date
- Map your Description column → Event body contains that text
- Map your Location column → Event shows that location
Required Mappings
These fields must be mapped for sync to work:
Event title
Item Name
Event Date
Date column
Example
Event Title: "Client Meeting"
Item: "Client Meeting"
Event Date: Jan 15
Date: Jan 15
Starts at: 10:00 AM
Time: 10:00 AM
Location: "Zoom"
Location: "Zoom"
Body: "Discuss Q1 goals"
Description: "Discuss Q1 goals"
⚠️ The sync only triggers when a mapped field changes. If you update a column that isn't mapped, nothing happens. Make sure the columns you care about are included in your mapping.
Incoming data and Outgoing data
The last two wizard steps decide which events and items sync:
- Incoming data — sync any Google event, or only events that meet conditions (e.g., Color is Basil). Here you also choose which group new items land in.
- Outgoing data — sync any monday item, or only items that meet conditions (e.g., Status is Confirmed).
Activate your sync
Once you've completed all 4 steps, click Activate Sync. The sync starts running immediately — new changes on either side will flow according to your settings.
How sync works
Incoming (Google Calendar → monday)
When changes occur in Google Calendar:
New event created → Creates a new item in monday.com
Event updated → Updates the linked item
Event deleted → Deletes the linked item (only if Sync deletions in both directions is on)
Items are linked via an Integration Column that stores the connection between item and event.
Outgoing (monday → Google Calendar)
When changes occur in monday.com :
Item created → Creates a new calendar event
Mapped column changed → Updates the calendar event
Item deleted → Deletes the linked event (only if Sync deletions in both directions is on)
Dive deeper
Common gotchas
- Each sync connects one calendar to one board — to sync multiple calendars, create multiple syncs
- The sync only triggers when a mapped field changes — unmapped columns are ignored
- You can import past or future events after activation from the Import Existing Events tab
- Imported events and synced changes both count as actions toward your plan quota
- The Integration Column is created automatically — don't delete or rename it
Next up
Related
- Set up your first sync — quick-start walkthrough
- Board Setup Best Practices — recommended columns and structure
- Connect your Google account — authentication deep dive
- Plans, Billing & Usage — how actions are counted
Still stuck?
If something isn't working as expected, check Troubleshooting or FAQ . You can also reach us at hello@fantasymedia.io .