Cal.com Setup Guide

This guide walks you through connecting your Cal.com account to Amfion so your AI assistant can check availability and book appointments automatically.

The entire setup takes about 10 minutes. You’ll need a Cal.com account and access to your Amfion admin panel.

Step 1: Create a Cal.com Account

Go to cal.com and sign up for a free account. Confirm your email and complete the basic profile setup.

Cal.com’s free tier works with Amfion — no paid plan is required to get started.

Step 2: Set Your Availability

In Cal.com, navigate to Availability in the sidebar. Set your working hours — these control when customers can book appointments with you.

Tip: You can create multiple availability schedules for different days or services. For example, weekday mornings for consultations and afternoons for follow-ups.

Step 3: Create an Event Type

Go to Event Types in Cal.com and click “New Event Type” → choose “One on One.”

Set the title (e.g. “Haircut,” “Consultation”), duration, and assign the availability schedule you created in Step 2.

After saving, note the Event Type ID. You can find it in the URL when viewing the event type:

cal.com/event-types/<ID>

Amfion stores these event type IDs automatically when you sync or import services, so you usually only need this for troubleshooting.

Step 4: Generate an API Key

Go to Settings → Developer → API Keys in Cal.com (or visit cal.com/settings/developer/api-keys directly).

  1. Click “Create new API key”
  2. Give it a name (e.g. “Amfion Integration”)
  3. Set expiration to “Never” (or your preferred expiration)
  4. Copy the key immediately — it won’t be shown again

The key starts with cal_live_.

Step 5: Connect Cal.com in Amfion

In your Amfion admin panel, go to Settings → Integrations.

  1. Paste your API key into the “API Key” field
  2. Click “Connect Cal.com”

The status badge should change from “Not connected” to “Connected.”

Step 6: Add Services

Go to the Services page in your Amfion admin panel and create services that match your Cal.com event types.

Set each service to Instant Booking if customers should be able to book it immediately. Then choose whether it should use your tenant default bookable hours, a custom schedule for that service, or stay managed directly in Cal.com.

Once connected, the AI agent will automatically check availability and create bookings through Cal.com when customers request appointments.

Troubleshooting

“Not connected” after saving?

Double-check that the API key has no extra spaces before or after it. If the issue persists, try generating a new key in Cal.com.

Bookings not appearing?

Verify the Event Type ID matches an active event type in Cal.com. Archived or deleted event types won’t accept bookings.

Wrong availability showing?

Check that your Cal.com availability schedule is assigned to the correct event type. Each event type can have its own schedule.