Setup Guide
A step-by-step guide to setting up and using Cal.com Sync for monday.com.
Prerequisites
- A monday.com account with admin permissions
- A Cal.com account with access to the event types you want to sync
Getting Started
Install the App
Install Cal.com Sync from the monday.com marketplace. Only account administrators can install apps.
During installation, you will be asked to grant permissions. The app requires:
- boards:read — Read board structure, columns, and groups
- boards:write — Create and update items and columns on your boards
- me:read — Identify the current user
Add the Board View
After installation:
- Open any board where you want Cal.com bookings to appear
- Click the + button next to your existing views
- Select Apps and find Cal.com Sync
- Click to add it as a new view on your board
Connecting Cal.com
Authorize monday.com
When you open the board view for the first time, you will be prompted to authorize the app. This grants Cal.com Sync permission to create items and columns on your boards.
Connect Your Cal.com Account
Click Connect Cal.com in the board view. A new tab opens to Cal.com's OAuth authorization page. Log in to Cal.com (if needed) and click Authorize.
The app requests read access to your Cal.com account, including bookings and event types (required for real-time sync). Once authorized, return to monday.com and click I've Completed Authorization.
Creating a Sync
After connecting, click New Sync to start the setup wizard.
Step 1: Select Source
Choose which Cal.com event types to sync. Select one or more event types (e.g., 30-min Meeting, Discovery Call). Only bookings for the selected event types will be synced.
Step 2: Select Target
Choose which group on your monday.com board should receive the synced bookings. Each sync maps to one group. You can create multiple syncs to different groups on the same board.
Step 3: Configure Fields & Confirm
Select which Cal.com booking fields to sync. For each enabled field, Cal.com Sync will automatically create the appropriate column on your board (or reuse an existing column with the same name).
| Field | Column Type | Description |
|---|---|---|
| Status | Status | Booking status: Accepted, Pending, Cancelled, Rejected, Rescheduled, No Show |
| Start Time | Date | Booking start date and time |
| End Time | Date | Booking end date and time |
| Duration (min) | Numbers | Booking duration in minutes |
| Location | Text | Meeting location — Zoom, Google Meet, phone, or in-person address |
| Attendees | Text | Comma-separated attendee names and emails |
| Attendee Email | Text | Email address of the primary attendee |
| Host | Text | Name of the booking host / organizer |
| Event Type | Text | Cal.com event type name (e.g., 30-min Meeting) |
| Notes | Long Text | Booking description or additional notes from the attendee |
| Booking ID | Text | Unique Cal.com booking identifier |
| Meeting Status | Status | Derived status: Upcoming, In Progress, Past, or Recurring |
| Cancellation Reason | Text | Reason provided when a booking is cancelled |
| Reschedule Reason | Text | Reason provided when a booking is rescheduled |
| Rescheduled From | Text | Reference to the original booking that was rescheduled |
| Created At | Date | Date and time the booking was created in Cal.com |
By default, Status, Start Time, End Time, and Location are enabled. Review your sync configuration and click Confirm to start. Once complete, your board is live with real-time updates.
Daily Usage
Once a sync is active, everything is automatic:
- New bookings in Cal.com → new items appear on your board within seconds
- Rescheduled bookings (time, attendees, etc.) → corresponding items update automatically
- Cancelled bookings in Cal.com → the status on the corresponding monday.com item updates to “Cancelled”
Managing Syncs
The dashboard shows all syncs for the current board. Each sync card displays the status label, number of synced bookings, and last update time.
- Pause a sync to temporarily stop updates (the Cal.com webhook is removed)
- Resume to re-enable updates (a new webhook is created)
- Delete to remove the sync entirely. Existing items on the board are never removed.
Note: Bookings created or updated in Cal.com while a sync is paused will not be retroactively synced when you resume. You can run multiple syncs on the same board — for example, one sync for Discovery Calls and another for Team Meetings, each targeting a different group.
Troubleshooting
- Sync shows “Board Not Found” or “Group Not Found” — The target board or group was deleted or archived. Restore it in monday.com, then click the refresh button on the sync card.
- Bookings not appearing — Verify the booking belongs to one of the selected event types.
- Authorization expired — The app refreshes tokens automatically. If it fails, reconnect Cal.com from the board view.
Need Help?
Email us at hello@usecalsync.com.