Cal.com Calendar Integration Setup Guide

This guide walks you through connecting your Cal.com account to your Sulus.ai voice assistant. Once configured, your assistant will check your availability, book appointments directly to your calendar, and send automatic confirmation messages to your clients.

What You Will Need

• An active Cal.com account at app.cal.com
• At least one event type already created in your Cal.com account
• The ability to log in to your Cal.com account

An API key (a special access code) lets Sulus.ai connect to your Cal.com account securely. You will create this key once and share it with Sulus.ai. Follow these steps carefully, as the key is only displayed one time.

Step 1: Open Your Account Settings

1. Log in to your Cal.com account at app.cal.com.
2. Look for your profile name or avatar in the upper right corner of the screen.
3. Click the dropdown arrow next to your name.
4. Select "My Settings" from the menu that appears.

Step 2: Navigate to API Keys

1. On the left side of the Settings page, look for a section labeled "Developer." It is near the bottom of the left sidebar menu.
2. Click on "API Keys" inside the Developer section.

Step 3: Create a New API Key

1. In the upper right corner of the API Keys page, click the button labeled "+ Add."
2. A dialog box titled "Create an API key" will appear on screen.

Step 4: Configure Your API Key

1. In the "Name this key" field, type exactly: Sulus
2. Find the "Expiration date" toggle and switch it to "Never expires." This prevents the connection from breaking in the future.
3. Click the "Save" button.

Step 5: Copy and Save Your API Key

1. A long string of letters and numbers will appear on screen. This is your API key.
2. Click the copy button next to the key, or highlight the entire key and press Ctrl+C (Windows) or Cmd+C (Mac).
3. Paste it somewhere safe right away, such as a password manager, a secure note, or a document saved only on your computer.

Step 6: Send Your API Key to Sulus.ai

1. Contact a Sulus.ai representative using the subject line: "Cal.com API Key for [Your Company Name]."
2. Include your copied API key in your message. Do not share this key anywhere else.

Your Event ID tells your Sulus.ai assistant which specific calendar event type to use when booking appointments. Each event type in Cal.com has a unique ID number that lives in the web address of its settings page.

Step 1: Open Your Event Type Settings

1. Log in to your Cal.com account at app.cal.com.
2. In the left sidebar, click "Event Types."
3. Find the event type you want your assistant to book, then click on its name to open its settings page.

Step 2: Find the Event ID in Your Browser Address Bar

1. Look at the address bar at the very top of your browser window. You will see a web address that looks similar to this:

Your Event ID is the number that appears between "/event-types/" and the next forward slash. In the example above, the Event ID is 1234567.

Step 3: Record Your Event ID

1. Copy or write down this number. You will need to provide it to Sulus.ai alongside your API key.

Your Cal.com booking form must collect certain information from the people scheduling appointments. This allows your Sulus.ai assistant to book appointments properly and send confirmation messages.

Required Fields Reference

Step 1: Open Your Event Type Booking Questions

1. Go to Event Types in the left sidebar of your Cal.com account.
2. Click on the same event type you used in Part 2.
3. Look for a tab or section labeled "Booking questions" or "Questions."

Step 2: Verify the Required Fields Are Active

1. Confirm that Name and Email Address are both toggled on and active.
2. Confirm that Phone Number is also toggled on. Set it to Optional or Required based on your preference.
3. These three fields are enabled by default in Cal.com. If any are missing, toggle them on now and save your changes.

Step 3: Add Custom Fields If Needed

If you need to collect information beyond Name, Email, and Phone Number, you have two options.

Option A: Add the field yourself in Cal.com

1. In the Booking Questions section, click "Add a question."
2. Choose the appropriate field type and fill in the field details.
3. Save your changes when finished.

Option B: Have Sulus.ai configure the field for you

1. Contact a Sulus.ai representative with the subject line: "Custom Booking Fields Request for [Your Company Name]."
2. List each field you need, such as Company Name, Job Title, Industry, or Budget Range.
3. The Sulus.ai team will configure these fields for you.

Before reaching out to Sulus.ai, use this checklist to confirm you have completed every step. Having all three items ready makes the setup process faster for everyone.

Your Submission Checklist

What to Include When You Contact Sulus.ai

Contact a Sulus.ai representative using the subject line: "Cal.com Configuration for [Your Company Name]" and include the following:

• Your Cal.com API key
• Your Event ID
• A list of any custom booking fields you need beyond Name, Email, and Phone (if applicable)

If something does not look right during setup, use the solutions below. If your issue is not listed here, contact a Sulus.ai representative for assistance.