Cal.com setup

ConfigView reads your Cal.com account through Cal.com’s API v2, using an API key that you create in Cal.com. You will end up with 1 secret in ConfigView (CALCOM_API_KEY) when setup is complete.

Scope of this integration today. ConfigView reads who has Cal.com and with what role, the teams they belong to, the video apps and calendars they have connected, the webhooks and workflows that send booking data to other systems, any domain-wide calendar access Cal.com has been given, and bookings from the last year and ahead. ConfigView only reads. It never creates, changes or cancels anything.

Step 1: Open the Cal.com page in ConfigView

Open ConfigView in a second browser tab and leave it open: https://{companyname}.configview.com/admin/integrations/calcom Cal.com shows the key once, when you create it, so paste it straight into ConfigView instead of keeping it in a notes file.

Step 2: Create an API key in Cal.com

Sign in to Cal.com as an organization owner or admin. See Which user owns the key below
Open Settings → Security → API keys
Create a new key. Name it ConfigView and choose Never expires if you can. A key with an expiry date stops working on that date without warning
Copy the key. A live key starts with cal_live_. A key starting with just cal_ is a test-mode key and sees no real data
Switch to the ConfigView tab, paste it into CALCOM_API_KEY under Credentials, and click the save icon

Which user owns the key

A Cal.com API key acts as the user who created it.

Organizations plan: the organization-wide lists (users, memberships, teams, webhooks, bookings, delegation credentials) need the key’s owner to be an organization admin or owner. A member’s key gets a 403 on every one of them, so those tables stay empty and only the key owner’s own data is collected.
Teams plan: there is no organization-wide view. ConfigView reads the teams the key’s owner belongs to, their members and their event types.

If the key’s owner leaves and their account is removed, collection stops. A shared admin account that won’t leave is the safer owner.

Step 3: Connect and verify

Back on https://{companyname}.configview.com/admin/integrations/calcom, confirm the credential shows as saved
Click Connect. ConfigView creates its tables and schedules every collector at your default run time. Stop any you don’t want under Collectors:

Script	Notes
Key Owner	The Cal.com account behind the API key, and the organization it belongs to (empty on a Teams plan).
Connected Calendars	Calendars the key owner has connected (Google, Outlook, Apple, CalDAV): account email, read-only flag and whether each is checked for conflicts.
Conferencing Apps	Video apps (Zoom, Google Meet, Teams, Cal Video) the key owner has installed, and which one is their default.
User Webhooks	Webhooks on the key owner’s account: the outside URL Cal.com posts booking data to, which events trigger it, and whether it is active.
Event Types	The key owner’s bookable event types: length, video app or location, destination calendar, redirect URL and visibility.
Schedules	The key owner’s availability schedules: name, time zone, whether it is the default, and how many blocks and overrides it has.
Workflows	The key owner’s automated workflows: what triggers them and which emails, SMS, WhatsApp messages or AI phone calls they send.
Verified Emails	Email addresses verified on the key owner’s account for sending workflow messages from.
Bookings	The key owner’s bookings over the last year and ahead: host, attendee emails, status, times, location and video link.
Organization Users	Every user in the Cal.com organization: name, email, username, when the account was created and whether the email is verified.
Organization Memberships	Each user’s role in the organization (owner, admin, member) and whether they accepted the invite.
Organization Teams	Teams inside the Cal.com organization, with their slug, privacy setting and time zone.
Organization Roles	Custom and built-in organization roles and the permissions each one grants.
Organization Attributes	Custom user attributes the organization defines (department, region, skills) and used for routing.
Attribute Options	The allowed values of each organization attribute.
Organization Webhooks	Organization-wide webhooks: the outside URL Cal.com sends booking data to for every member, and which events trigger it.
Delegation Credentials	Domain-wide calendar access granted to Cal.com: which Google Workspace or Microsoft 365 domain, the service account, and whether it is on.
Organization Schedules	Availability schedules of every user in the organization: owner, time zone, default flag, blocks and overrides.
Out of Office	Out-of-office entries across the organization: who, when, the reason, and who bookings are redirected to.
Routing Forms	Routing forms that send people who book to a team or person, with how many fields and routes each has.
Routing Form Responses	When each routing form was filled in and which booking it led to. The answers themselves are not stored.
Organization Bookings	Every booking in the organization over the last year and ahead: host, attendee emails, status, times, location and video link.
Team Event Types	Every team event type in the organization: round-robin or collective, hosts, video app and destination calendar.
User Event Types	Each organization user’s personal event types: length, video app or location, destination calendar and redirect URL.
Event Type Webhooks	Webhooks attached to the key owner’s event types: the outside URL that receives their bookings and which events trigger it.
User Conferencing Apps	Video apps each organization user has connected (Zoom, Google Meet, Teams, Cal Video), their default, and any broken connection.
Team Memberships	Who belongs to each organization team, their team role and whether they accepted.
Team Workflows	Automated team workflows: what triggers them and which emails, SMS, WhatsApp messages or AI phone calls they send.
Team Conferencing Apps	Video apps installed at team level and which one each team uses by default.
Team Verified Emails	Email addresses verified for a team to send workflow messages from.
Teams	Teams the key owner belongs to on a Cal.com Teams plan (Organizations accounts use Organization Teams).
Teams-Plan Memberships	Who belongs to each team on a Teams plan, their role and whether they accepted.
Teams-Plan Event Types	Team event types on a Teams plan: round-robin or collective, hosts, video app and destination calendar.

Click Verify now. The health check confirms the key, reports whether this is an Organizations account, then reads one record from each kind of data the plan offers.

If a check fails:

Auth fails with 401. The key is wrong, revoked, or past its expiry date. Create a new key and paste it again.
Organization checks are skipped with 403. The key’s owner is not an organization admin or owner. Create the key from an admin account.
“Teams (Teams plan)” is skipped on an Organizations account. Expected: Cal.com serves team data to organizations under the organization endpoints instead.

Data Tables

Once the scripts run, these tables are created in your database. Each includes a run_at column for historical tracking, and a raw_json column holding the record as Cal.com returned it, minus the fields listed under What isn’t collected. Each table keeps only the newest run.

Table	Source	Key Columns
`calcom_me`	`GET /v2/me`	user_id, uuid, email, name, username, time_zone, organization_id, organization_is_platform
`calcom_calendars`	`GET /v2/calendars`	integration, integration_title, account_email, credential_id, delegation_credential_id, calendar_external_id, calendar_name, calendar_email, is_primary, read_only, is_selected, is_destination
`calcom_conferencing`	`GET /v2/conferencing`	credential_id, app_type, app_slug, owner_user_id, is_default, invalid
`calcom_webhooks`	`GET /v2/webhooks`	webhook_id, subscriber_url, active, triggers, payload_version, has_payload_template, has_secret, delay_value, delay_unit
`calcom_event_types`	`GET /v2/event-types`	event_type_id, title, slug, length_minutes, hidden, locations, destination_calendar, owner_id, schedule_id, price, currency, seats_per_time_slot, requires_booker_email_verification, booking_requires_authentication, hide_calendar_event_details, success_redirect_url, booking_url, booking_field_count
`calcom_schedules`	`GET /v2/schedules`	schedule_id, owner_id, name, time_zone, is_default, availability_blocks, override_count
`calcom_workflows`	`GET /v2/workflows`	workflow_id, name, workflow_type, owner_user_id, owner_team_id, trigger_type, active_on_all_event_types, active_on_event_type_ids, step_actions, step_recipients, step_count, created_at, updated_at
`calcom_verified_emails`	`GET /v2/verified-resources/emails`	verified_email_id, email, owner_user_id, owner_team_id
`calcom_bookings`	`GET /v2/bookings`	booking_id, uid, title, status, start_time, end_time, duration_minutes, event_type_id, event_type_slug, host_emails, attendee_emails, attendee_count, guest_emails, location, meeting_url, absent_host, rating, cancelled_by_email, rescheduled_by_email, rescheduled_from_uid, created_at, updated_at
`calcom_org_users`	`GET /v2/organizations/{orgId}/users`	org_id, user_id, uuid, email, name, username, email_verified_at, verified, time_zone, locale, invited_to, created_date
`calcom_org_memberships`	`GET /v2/organizations/{orgId}/memberships`	org_id, membership_id, member_user_id, member_team_id, member_email, member_name, member_username, role, accepted, disable_impersonation, attributes
`calcom_org_teams`	`GET /v2/organizations/{orgId}/teams`	org_id, team_id, name, slug, parent_id, is_organization, is_private, hide_book_a_team_member, time_zone
`calcom_org_roles`	`GET /v2/organizations/{orgId}/roles`	org_id, role_id, name, role_type, description, permissions, permission_count, created_at, updated_at
`calcom_org_attributes`	`GET /v2/organizations/{orgId}/attributes`	org_id, attribute_id, name, slug, attribute_type, enabled, users_can_edit
`calcom_org_attribute_options`	`GET /v2/organizations/{orgId}/attributes/{attributeId}/options`	org_id, attribute_id, attribute_name, option_id, option_value, slug
`calcom_org_webhooks`	`GET /v2/organizations/{orgId}/webhooks`	org_id, webhook_id, subscriber_url, active, triggers, payload_version, has_payload_template, has_secret, delay_value, delay_unit, webhook_team_id
`calcom_org_delegation_credentials`	`GET /v2/organizations/{orgId}/delegation-credentials`	org_id, credential_id, domain, enabled, workspace_platform, service_account_client_id, created_at, updated_at
`calcom_org_schedules`	`GET /v2/organizations/{orgId}/schedules`	org_id, schedule_id, owner_id, name, time_zone, is_default, availability_blocks, override_count
`calcom_org_ooo`	`GET /v2/organizations/{orgId}/ooo`	org_id, ooo_id, ooo_user_id, redirect_to_user_id, start_time, end_time, reason
`calcom_org_routing_forms`	`GET /v2/organizations/{orgId}/routing-forms`	org_id, routing_form_id, name, form_team_id, form_user_id, disabled, field_count, route_count, created_at, updated_at
`calcom_org_routing_form_responses`	`GET /v2/organizations/{orgId}/routing-forms/{routingFormId}/responses`	org_id, routing_form_id, routing_form_name, response_id, form_filler_id, routed_to_booking_uid, created_at
`calcom_org_bookings`	`GET /v2/organizations/{orgId}/bookings`	org_id, booking_id, uid, title, status, start_time, end_time, duration_minutes, event_type_id, event_type_slug, host_emails, attendee_emails, attendee_count, guest_emails, location, meeting_url, absent_host, rating, cancelled_by_email, rescheduled_by_email, rescheduled_from_uid, created_at, updated_at
`calcom_org_team_event_types`	`GET /v2/organizations/{orgId}/teams/event-types`	org_id, event_type_id, title, slug, length_minutes, hidden, locations, destination_calendar, owner_id, schedule_id, price, currency, seats_per_time_slot, requires_booker_email_verification, booking_requires_authentication, hide_calendar_event_details, success_redirect_url, booking_url, booking_field_count, event_team_id, scheduling_type, assign_all_team_members, host_user_ids, host_count, parent_event_type_id
`calcom_org_user_event_types`	`GET /v2/event-types?username=&orgId=`	org_id, user_id, username, user_email, event_type_id, title, slug, length_minutes, hidden, locations, destination_calendar, owner_id, schedule_id, price, currency, seats_per_time_slot, requires_booker_email_verification, booking_requires_authentication, hide_calendar_event_details, success_redirect_url, booking_url, booking_field_count
`calcom_org_event_type_webhooks`	`GET /v2/event-types/{eventTypeId}/webhooks`	event_type_id, event_type_slug, webhook_id, subscriber_url, active, triggers, payload_version, has_payload_template, has_secret, delay_value, delay_unit
`calcom_org_user_conferencing`	`GET /v2/organizations/{orgId}/users/{userId}/conferencing`	org_id, user_id, username, user_email, credential_id, app_type, app_slug, owner_user_id, is_default, invalid
`calcom_org_team_memberships`	`GET /v2/organizations/{orgId}/teams/{teamId}/memberships`	org_id, team_id, team_name, membership_id, member_user_id, member_team_id, member_email, member_name, member_username, role, accepted, disable_impersonation
`calcom_org_team_workflows`	`GET /v2/organizations/{orgId}/teams/{teamId}/workflows`	org_id, team_id, team_name, workflow_id, name, workflow_type, owner_user_id, owner_team_id, trigger_type, active_on_all_event_types, active_on_event_type_ids, step_actions, step_recipients, step_count, created_at, updated_at
`calcom_org_team_conferencing`	`GET /v2/organizations/{orgId}/teams/{teamId}/conferencing`	org_id, team_id, team_name, credential_id, app_type, app_slug, owner_user_id, is_default, invalid
`calcom_org_team_verified_emails`	`GET /v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails`	org_id, team_id, team_name, verified_email_id, email, owner_user_id, owner_team_id
`calcom_teams`	`GET /v2/teams`	team_id, name, slug, parent_id, is_organization, is_private, hide_book_a_team_member, time_zone
`calcom_team_memberships`	`GET /v2/teams/{teamId}/memberships`	team_id, team_name, membership_id, member_user_id, member_team_id, member_email, member_name, member_username, role, accepted, disable_impersonation
`calcom_team_event_types`	`GET /v2/teams/{teamId}/event-types`	team_id, team_name, event_type_id, title, slug, length_minutes, hidden, locations, destination_calendar, owner_id, schedule_id, price, currency, seats_per_time_slot, requires_booker_email_verification, booking_requires_authentication, hide_calendar_event_details, success_redirect_url, booking_url, booking_field_count, event_team_id, scheduling_type, assign_all_team_members, host_user_ids, host_count, parent_event_type_id

Things worth knowing

About half the tables will be empty, and that’s expected. Cal.com serves organization data only to Organizations accounts and team data only to Teams accounts. ConfigView collects both families. calcom_me.organization_id tells you which one applies: when it’s filled in, read the calcom_org_* tables. Connected calendars are the key owner’s only. Cal.com has no organization-wide list of connected calendars. To see who else gave Cal.com access to their calendar, look at the Google Workspace or Microsoft 365 integration’s app grants. locations names the video app. An event type’s locations column reads like integration:zoom or integration:google-meet. That’s where a booking’s meeting link comes from. Bookings cover a rolling window. Each run reads bookings that started in the last 365 days plus everything booked ahead. Older bookings drop out of the table. Event type webhooks are the key owner’s only. Cal.com refuses to show webhooks on another user’s event type, even to an organization admin. Organization-wide webhooks are collected in full. User event types are the public list. calcom_org_user_event_types reads each user’s booking page, so event types they’ve hidden may be missing.

What isn’t collected

Webhook signing secrets. has_secret records only that one exists
Booking descriptions, booking-form answers and cancellation or rescheduling reasons, which are free text typed in by the person booking
Routing form answers. Only when a form was filled in and which booking it led to
Meeting recordings and transcripts

Platform

Integrations

Step 1: Open the Cal.com page in ConfigView

Step 2: Create an API key in Cal.com

Which user owns the key

Step 3: Connect and verify

Data Tables

Things worth knowing

What isn’t collected

​Step 1: Open the Cal.com page in ConfigView

​Step 2: Create an API key in Cal.com

​Which user owns the key

​Step 3: Connect and verify

​Data Tables

​Things worth knowing

​What isn’t collected

Step 1: Open the Cal.com page in ConfigView

Step 2: Create an API key in Cal.com

Which user owns the key

Step 3: Connect and verify

Data Tables

Things worth knowing

What isn’t collected