CAL_DELETE_WEBHOOK_BY_ID - Remove a webhook [Optional]
Key parameters:
id: Webhook ID for GET/UPDATE/DELETE operations
subscriberUrl: Webhook endpoint URL
eventTriggers: Array of event types to trigger on
active: Whether the webhook is active
secret: Webhook signing secret
Pitfalls:
Webhook URLs must be publicly accessible HTTPS endpoints
Event triggers include: 'BOOKING_CREATED', 'BOOKING_RESCHEDULED', 'BOOKING_CANCELLED', etc.
Inactive webhooks do not fire; toggle active to enable/disable
Webhook secrets are used for payload signature verification
4. Manage Teams
When to use: User wants to create, view, or manage teams and team event types
Tool sequence:
CAL_GET_TEAMS_LIST - List all teams [Required]
CAL_GET_TEAM_INFORMATION_BY_TEAM_ID - Get specific team details [Optional]
CAL_CREATE_TEAM_IN_ORGANIZATION - Create a new team [Optional]
CAL_RETRIEVE_TEAM_EVENT_TYPES - List event types for a team [Optional]
Key parameters:
teamId: Team identifier
name: Team name (for creation)
slug: URL-friendly team identifier
Pitfalls:
Team creation may require organization-level permissions
Team event types are separate from personal event types
Team slugs must be URL-safe and unique within the organization
5. Organization Management
When to use: User wants to view organization details
Tool sequence:
CAL_GET_ORGANIZATION_ID - Get the organization ID [Required]
Key parameters: (none required)
Pitfalls:
Organization ID is needed for team creation and org-level operations
Not all Cal.com accounts have organizations; personal plans may return errors
Common Patterns
Booking Creation Flow
1. Call CAL_GET_AVAILABLE_SLOTS_INFO to find open slots
2. Present available times to the user
3. Call CAL_POST_NEW_BOOKING_REQUEST with selected slot
4. Confirm booking creation response
ID Resolution
Team name -> Team ID:
1. Call CAL_GET_TEAMS_LIST
2. Find team by name in response
3. Extract id field
Webhook Setup
1. Call CAL_RETRIEVE_WEBHOOKS_LIST to check existing hooks
2. Create or update webhook with desired triggers
3. Verify webhook fires on test booking
Known Pitfalls
Date/Time Formats:
Booking times: ISO 8601 with timezone (e.g., '2024-01-15T09:00:00Z')
Availability dates: YYYY-MM-DD format
Always specify timezone explicitly to avoid confusion
Event Types:
Event type IDs are numeric integers
Event types define duration, location, and booking rules
Disabled event types cannot accept new bookings
Permissions:
Team operations require team membership or admin access
