Cal.com: Workflow Actions & Triggers

What are Cal.com Actions & Triggers in Workflows?

Cal.com Actions & Triggers in Workflows allow you to connect your scheduling activity directly to your CRM's automation engine. This integration enables two-way communication between your calendar and your workflows. Triggers automatically start a workflow when a specific event occurs in Cal.com, such as a new booking. Conversely, actions allow a workflow to perform operations within Cal.com, like creating or rescheduling an appointment.

Key Benefits of Using Cal.com with Workflows

Automating the link between scheduling and your CRM offers several significant advantages for your team's efficiency and customer communication.

• End-to-End Automation: Capture the entire booking lifecycle, from creation and rescheduling to cancellation and completion.
• Rapid Response: Triggers are event-driven and activate workflows within seconds, allowing for immediate confirmations and follow-ups.
• Dynamic Scheduling: Use workflow data, such as a new lead from a form, to automatically create a booking in Cal.com.
• Rich Data Access: Booking events provide detailed information like attendee details, times, and notes for use in subsequent workflow steps.
• Single Connection: Connect your Cal.com account once at the sub-account level, and use it across all workflows without re-authenticating.

Connecting Your Cal.com Account

Before you can use Cal.com triggers or actions, you must establish a secure connection between the two platforms.

You can initiate the connection from within the Workflow Builder. When adding a Cal.com trigger or action step, if the account is not yet connected, you will see a Connect Now button. Click it and authenticate using your Cal.com API key or, if available, OAuth. You will need to authorize the specific Cal.com workspace and event types you wish to access.

Alternatively, you can connect the integration globally by navigating to Sub-Account Settings → Integrations → Cal.com and clicking Connect.

Cal.com Triggers

Triggers are used to start a workflow based on an event that happens in Cal.com. They are ideal for automating tasks like contact creation, sending messages, or starting a follow-up sequence when a booking changes.

• Booking Created: Activates when a new booking is made. The workflow receives the full booking details.
• Booking Rescheduled: Activates when an existing booking's time is changed. Provides data for both the original and new times.
• Booking Cancelled: Activates when a booking is cancelled. May include the reason for cancellation if one was provided.
• Meeting Ended: Activates at the scheduled end time of a booking. If a booking is rescheduled, this trigger will re-arm for the new end time.
• OOO Created / Updated: Activates when an out-of-office entry is created or modified in Cal.com.

Cal.com Actions

Actions allow your workflows to interact with Cal.com. Use them to manage bookings directly from your automations. Please note that all Cal.com actions are premium features and consume action credits when they run.

• Create Booking: Schedules a new appointment. Required information includes the Event Type, Attendee Name, Attendee Email, and Start Time.
• Cancel Booking: Cancels an existing booking using its unique ID. You can optionally provide a cancellation reason.
• Reschedule Booking: Changes the start time of an existing booking. Cal.com will handle sending updated calendar invitations.
• Find Booking: Searches for a booking by its ID, attendee email, or other filters and returns the matching booking data.

Testing Cal.com Triggers and Actions

It is crucial to test your setup before publishing a workflow to ensure the connection is working and data is mapping correctly.

Testing a Cal.com Trigger

To test a trigger, such as 'Booking Created':

1. Open your workflow and click Add Trigger.
2. Go to the Apps tab, search for 'Cal.com', and select the desired trigger.
3. Give the trigger a descriptive name (e.g., 'New Client Booking').
4. Optionally, add filters to ensure the trigger only activates for specific event types or hosts.
5. The trigger panel will display the status of the underlying webhook. If it becomes inactive, you may need to reconnect the integration.

To complete the test, create a real booking in Cal.com that matches your trigger criteria and verify that it successfully enrolls a contact into your workflow.

Testing a Cal.com Action

To test an action, such as 'Create Booking':

1. Add the Cal.com action step to your workflow.
2. Configure the required fields, like Event Type and Attendee Email.
3. Run a test on the workflow step. The system will attempt to create the booking in Cal.com, and you can check your Cal.com calendar to confirm it was created successfully.