Connection is live today. AI booking actions (book, check availability, cancel, reschedule) and automatic booking-to-lead capture are rolling out incrementally. Connect your account now to be ready.
Why Connect Cal.com?
- Book in chat: Visitors book meetings without leaving the conversation
- Capture leads: Every booking is saved as a lead with attendee details
- Real-time availability: Show open slots straight from your Cal.com calendar
- 24/7 scheduling: Take bookings outside business hours
- Cal.com or Cal.eu: Works with both the global and European instances
Prerequisites
- An active Cal.com account on Cal.com (
app.cal.com) or Cal.eu (app.cal.eu) - At least one event type set up in Cal.com
Connect to Cal.com
Authorize on Cal.com
You’ll be redirected to Cal.com. Log in (if needed) and click Allow to grant BubblaV access. BubblaV uses PKCE OAuth, so there’s no client secret to handle.
Cal.eu accounts
If your Cal.com account is on the European instance (app.cal.eu), your BubblaV admin must point BubblaV at the EU endpoints (CALCOM_OAUTH_AUTHORIZE_URL, CALCOM_OAUTH_TOKEN_URL, CALCOM_API_BASE_URL) before you connect. The OAuth client and your account must be on the same instance.
What This Enables
Once connected, BubblaV is authorized to access your Cal.com account with these scopes:| Scope | What it allows |
|---|---|
BOOKING_READ | View your bookings (capture as leads, show “my appointments”) |
BOOKING_WRITE | Create, cancel, and reschedule bookings |
EVENT_TYPE_READ | List your event types (show available meetings to book) |
PROFILE_READ | Verify the connected account |
Reconnecting
If your connection expires or you need to switch accounts, click Reconnect on the Cal.com integration card. You’ll go through the OAuth flow again to get fresh credentials.Troubleshooting
Can't log in / wrong Cal.com instance
Can't log in / wrong Cal.com instance
- Your Cal.com account and the BubblaV OAuth client must be on the same instance (both
app.cal.comor bothapp.cal.eu). - If your account is on Cal.eu, ask your BubblaV admin to configure the EU endpoints, then reconnect.
Authorization failed or access denied
Authorization failed or access denied
Redirect URI mismatch
Redirect URI mismatch
- The callback URL registered on your Cal.com OAuth client must exactly match
https://www.bubblav.com/api/integrations/calcom/oauth/callback(plus any preview/dev URLs your admin registered).
OAuth client pending review
OAuth client pending review
- While BubblaV’s Cal.com OAuth client is pending Cal.com admin review, only the client owner can authorize. Other users can connect once it’s approved.
Connection expired
Connection expired
- Access tokens refresh automatically in the background.
- If you see a connection error, click Reconnect on the integration card.
