# Cal.com Your Toolhouse AI Worker can connect to Cal.com using 175 specialized tools. ## Auth Connection This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=cal). ## Tools (175) ### `Cal Add Attendee` Integration name: **CAL\_ADD\_ATTENDEE** Tool to create a new attendee for an existing booking in Cal.com. Use when you need to add an additional participant to a scheduled event. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | ------------------------ | --------------------------------------------------------------------------- | | `name` | string | ✅ | `"John Doe"` | Full name of the attendee. | | `email` | string | ✅ | `"john.doe@example.com"` | Email address of the attendee. Must be a valid email format. | | `timeZone` | string | ✅ | `"America/New_York"` | IANA timezone for the attendee (e.g., `America/New_York`, `Europe/London`). | | `bookingId` | integer | ✅ | `15100664` | The unique identifier of the booking to add the attendee to. | *** ### `Cal Add Member To Team Using Org And Team Id` Integration name: **CAL\_ADD\_MEMBER\_TO\_TEAM\_USING\_ORG\_AND\_TEAM\_ID** Adds a new member to a specified team within an organization by creating a team membership. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ---------- | -------------------------------------------------------------------------------------------------------------- | | `role` | string | | `"MEMBER"` | Specifies the user's role within the team (e.g., `MEMBER`, `OWNER`, `ADMIN`). | | `orgId` | integer | ✅ | `123` | The unique identifier of the organization to which the team belongs. | | `teamId` | integer | ✅ | `789` | The unique identifier of the team to which the member will be added. | | `userId` | integer | ✅ | `112` | The unique identifier of the user to be added to the team. | | `accepted` | boolean | | `true` | Indicates whether the membership invitation is accepted; `True` for active member, `False` for pending status. | | `disableImpersonation` | boolean | | `true` | If `True`, this user cannot be impersonated by administrators or those with impersonation privileges. | *** ### `Cal Add Organization Attribute Option` Integration name: **CAL\_ADD\_ORGANIZATION\_ATTRIBUTE\_OPTION** Adds a new option to an organization's SINGLE\_SELECT or MULTI\_SELECT attribute. Use this action to extend the available choices for an existing attribute. For example, adding a new department option like `"Marketing"` to a `"Department"` attribute. Prerequisites: - The organization must exist and the user must have admin access - The attribute must already exist and be of type SINGLE\_SELECT or MULTI\_SELECT Common use cases: - Adding new department options to a department selector - Expanding location choices for a location attribute - Creating new priority levels for a priority field Note: While it's recommended to use unique slugs for clarity, the API may allow duplicate slugs. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `slug` | string | ✅ | `"engineering"` | A URL-friendly programmatic identifier for the new option. Typically lowercase with hyphens (e.g., `engineering`, `sales-dept`). Used for programmatic access and filtering. While recommended to be unique, the API may allow duplicate slugs. | | `orgId` | integer | ✅ | `1001` | The unique numeric identifier of the organization. Obtain this from the user's profile (organizationId field) or from organization membership data. | | `value` | string | ✅ | `"Engineering"` | The human-readable display name for the new option (e.g., `Engineering`, `Sales Team`). This is what users will see when selecting from the attribute options. | | `attributeId` | string | ✅ | `"clq1abc123def456"` | The unique identifier of the attribute to which the new option will be added. Obtain this from the `retrieve_organization_attributes` action or when creating an attribute. Only attributes of type `SINGLE_SELECT` or `MULTI_SELECT` can have options. | *** ### `Cal Cancel Booking Via Uid` Integration name: **CAL\_CANCEL\_BOOKING\_VIA\_UID** Cancels an existing and active Cal.com booking using its unique identifier (UID). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------------------- | ------- | :------: | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | `seatUid` | string | | `"seat_123abc"` | For seated bookings only: the UID of the specific seat to cancel when cancelling as an attendee. | | `bookingUid` | string | ✅ | `"bk_XXXXXXXXXXXXX_YYYYYYYYYYYYY"` | The unique identifier (UID) of the booking to be cancelled. This UID is generated by Cal.com when a booking is created. | | `cancellationReason` | string | | `"User requested cancellation"` | Optional reason for cancelling the booking. Recommended for clear communication with the attendee. | | `cancelSubsequentBookings` | boolean | | `true` | For recurring bookings only: if true, cancels the booking with the given bookingUid and all subsequent recurrences. | *** ### `Cal Check Calendar Version2` Integration name: **CAL\_CHECK\_CALENDAR\_VERSION2** Retrieves free/busy availability for a specified calendar to aid scheduling without revealing event details; requires an existing, accessible calendar, noting that data granularity can vary. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------- | --------------------------------------------------------------------------------------------- | | `calendar` | string | ✅ | `"google"` | The calendar type to check availability for. Must be one of the supported calendar providers. | *** ### `Cal Check Gcal Synchronization Status` Integration name: **CAL\_CHECK\_GCAL\_SYNCHRONIZATION\_STATUS** Call this read-only action to verify the connection and synchronization status of a user's Google Calendar integration with Cal. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Check Ics Feed Calendar Endpoint` Integration name: **CAL\_CHECK\_ICS\_FEED\_CALENDAR\_ENDPOINT** Checks an ICS feed URL (expected as a query parameter) to verify its validity, accessibility, and iCalendar data integrity. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Check Stripe Status` Integration name: **CAL\_CHECK\_STRIPE\_STATUS** Verifies if Stripe is correctly connected to the Cal scheduling system and functional for processing payments, reporting only on the integration's status. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Check Team Stripe Integration Status` Integration name: **CAL\_CHECK\_TEAM\_STRIPE\_INTEGRATION\_STATUS** Retrieves the Stripe integration status and related information for a team, primarily to verify account connection, subscription details, or payment setup; this is a read-only operation that does not modify Stripe settings. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ----------------------------------- | -------------------------------------------------------------------------------------- | | `teamId` | string | ✅ | `"team_01H4S3X9N4K2PZJ5C6R8G7V0A0"` | The unique identifier of the team whose Stripe integration status needs to be checked. | *** ### `Cal Confirm Booking By Uid` Integration name: **CAL\_CONFIRM\_BOOKING\_BY\_UID** Confirms an existing booking by `bookingUid` if the booking exists and is in a state allowing confirmation (e.g., not already cancelled or confirmed); this finalizes the booking, does not modify its details, and should typically be performed once. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ---------------- | ---------------------------------------------------------------------- | | `bookingUid` | string | ✅ | `"bk_123xyz789"` | The unique identifier (UID) of the booking that needs to be confirmed. | *** ### `Cal Connect To Calendar` Integration name: **CAL\_CONNECT\_TO\_CALENDAR** Initiates or checks the external connection status for a specified calendar, possibly returning a redirect URL for user authorization to complete integration, without altering calendar data. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------- | ----------------------------------------------------------------------- | | `calendar` | string | ✅ | `"google"` | The calendar type to connect to. Valid values: apple, google, office365 | *** ### `Cal Create Membership For Organization` Integration name: **CAL\_CREATE\_MEMBERSHIP\_FOR\_ORGANIZATION** Creates a new membership for a user within a Cal.com organization. The caller must have admin/owner access to the organization, and the target user must already exist in the system. Use `CAL_RETRIEVE_USERS_IN_ORGANIZATION` to get valid user IDs. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | `role` | string | | `"MEMBER"` | The role to assign to the user within the organization. MEMBER has basic access, ADMIN can manage members and settings, OWNER has full control. | | `orgId` | integer | ✅ | `12345` | The unique identifier of the organization to add the membership to. The caller must have admin or owner permissions in this organization. | | `userId` | integer | ✅ | `2090888` | The unique identifier of the user to add to the organization. The user must already exist in the Cal.com system. | | `accepted` | boolean | | — | Whether the membership should be automatically accepted. If False, the user will receive an invitation to join. If True, they are added directly. | | `disableImpersonation` | boolean | | — | If True, prevents organization admins and owners from impersonating this user. Useful for security-sensitive accounts. | *** ### `Cal Create Oauth Client User` Integration name: **CAL\_CREATE\_OAUTH\_CLIENT\_USER** Creates a new managed user for a Cal.com Platform OAuth client. This is a Platform API endpoint that requires OAuth client credentials (`clientId` and `x-cal-secret-key`). The endpoint is deprecated as of December 2025 but remains functional for existing Platform customers. Key behaviors: - If `timeZone` is provided: A default working schedule (Mon-Fri, 9AM-5PM) is automatically created - If `timeZone` is omitted: No default schedule is created; you must manually create one via the `/schedules` endpoint before the user can receive bookings Returns access and refresh tokens for the created managed user that should be stored securely. Access tokens expire in 60 minutes; refresh tokens expire in 1 year. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------- | :------: | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"Jane Doe"` | Full name of the new managed user, used in communications and the Cal.com interface. | | `email` | string | ✅ | `"jane.doe@example.com"` | Email address for the new managed user. | | `locale` | string | | `"en"` | User's preferred language and regional settings as a locale code (e.g., `en`, `es`). | | `clientId` | string | ✅ | `"client_abc123xyz"` | Unique identifier of the OAuth client. This often needs to match the `clientId` in the API path. | | `timeZone` | string | | `"America/New_York"` | IANA timezone (e.g., `America/New_York`) for the user's default schedule (Mon-Fri, 9AM-5PM). For behavior when omitted, see action description; `Europe/London` may serve as a fallback. | | `avatarUrl` | string | | `"https://example.com/avatars/jane.png"` | Publicly accessible URL for the user's avatar image to be used as their profile picture. | | `weekStart` | string | | `"Monday"` | Day on which the user's week starts (e.g., `Monday`, `Sunday`). | | `timeFormat` | integer | | `12` | User's preferred time display format: 12 for 12-hour, 24 for 24-hour. | | `x_cal_secret_key` | string | ✅ | `"cal_secret_abc123xyz"` | The OAuth client secret key, required for authentication. This is obtained when registering an OAuth client application with Cal.com. | *** ### `Cal Create Oauth Client Webhook Configuration` Integration name: **CAL\_CREATE\_OAUTH\_CLIENT\_WEBHOOK\_CONFIGURATION** Creates a webhook configuration for an OAuth client to receive real-time event notifications from Cal.com. This is a Platform API endpoint that requires OAuth client credentials (`clientId` and `x-cal-secret-key`). Use this to set up automated workflows by subscribing to events like `BOOKING_CREATED`, `BOOKING_CANCELLED`, `MEETING_ENDED`, `FORM_SUBMITTED`, and more. The webhook will POST event data to your specified `subscriberUrl`. Key features: - Subscribe to multiple event triggers in a single webhook - Optionally customize the payload using a template - Secure webhooks with a secret for signature verification (`X-Cal-Signature-256` header) - Control webhook activation status (`active`/`inactive`) Note: This endpoint is part of the deprecated Platform offering but remains functional for existing customers. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------- | :------: | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `active` | boolean | ✅ | `true` | Whether the webhook should be active upon creation. Set to true to start receiving notifications immediately, or false to create in an inactive state for later activation. Default recommendation: true for production webhooks, false for testing/development. | | `secret` | string | | `"mySuperSecretKey123"` | An optional secret key used to sign the webhook payloads. This allows your `subscriberUrl` to verify that incoming requests are genuinely from Cal.com. If provided, Cal.com will include an `X-Cal-Signature-256` header in webhook requests. | | `clientId` | string | ✅ | `"clxj8s9j3000108l37twm86xy"` | The unique identifier of the OAuth client for which to create the webhook. This is obtained when you create an OAuth client via the Cal.com Platform settings or the POST `/v2/oauth-clients` API endpoint. | | `triggers` | array | ✅ | `["BOOKING_CREATED"]` | A list of event types that will trigger this webhook. You can subscribe to multiple event triggers. Choose from the available event triggers such as `BOOKING_CREATED`, `BOOKING_CANCELLED`, `MEETING_ENDED`, etc. | | `subscriberUrl` | string | ✅ | `"https://example.com/webhook-receiver"` | The HTTPS URL to which webhook notifications will be POSTed. This endpoint must be capable of receiving and processing these notifications. | | `payloadTemplate` | string | | — | Optional JSON template for the webhook payload. This allows customization of the data sent to the `subscriberUrl`. Refer to Cal.com documentation (`cal.com/docs/core-features/webhooks`) for details on template syntax and available variables. | | `x_cal_secret_key` | string | ✅ | `"cal_secret_abc123xyz"` | The OAuth client secret key required for Platform authentication. This key is obtained when registering an OAuth client application with Cal.com. It is used to sign and verify requests to OAuth client webhook endpoints. | *** ### `Cal Create Organization Attributes` Integration name: **CAL\_CREATE\_ORGANIZATION\_ATTRIBUTES** Creates a new custom attribute for an existing organization, used to enhance data collection for event bookings or user profiles. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"Department"` | The human-readable display name for the organization attribute. | | `slug` | string | ✅ | `"department"` | A unique, URL-friendly identifier for the organization attribute, typically a lowercase version of the name with spaces or special characters replaced by hyphens or underscores. This slug must be unique within the organization. | | `type` | string | ✅ | — | The data type of the organization attribute, determining its behavior and storage. | | `orgId` | integer | ✅ | — | The unique identifier of the organization for which this attribute is being created. This ID is used in the API request path. | | `enabled` | boolean | | — | Indicates whether the organization attribute is active and usable upon creation. Set to `true` to enable, `false` to disable. If not specified, the system's default behavior for new attributes (e.g., enabled) will apply. | | `options` | array | ✅ | — | A list of options for the attribute. This field is always required. For `SINGLE_SELECT` or `MULTI_SELECT` types, this list must contain at least one option definition. For `TEXT` or `NUMBER` types, an empty list `[]` should be provided. | *** ### `Cal Create Organization Team Form Workflow` Integration name: **CAL\_CREATE\_ORGANIZATION\_TEAM\_FORM\_WORKFLOW** Tool to create a new workflow for routing forms within an organization team. Use when you need to set up automated actions (like sending emails or SMS) triggered by routing form submissions. Supports notification workflows with customizable triggers, steps, and activation settings. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"Test Routing Form Workflow"` | Name of the workflow to identify it in the system. | | `orgId` | integer | ✅ | `184337` | The unique identifier of the organization. You must have access to this organization. | | `steps` | array | ✅ | — | List of steps to execute as part of the workflow. Allowed actions are: `email_attendee`, `email_address`, `sms_attendee`, `sms_number`. | | `teamId` | integer | ✅ | `184346` | The unique identifier of the team within the organization. | | `trigger` | object | ✅ | — | Trigger configuration that determines when the workflow executes. | | `activation` | object | ✅ | — | Activation settings that determine which routing forms this workflow applies to. | *** ### `Cal Create Organization Webhook By Org Id` Integration name: **CAL\_CREATE\_ORGANIZATION\_WEBHOOK\_BY\_ORG\_ID** Creates a webhook for an organization that sends HTTP POST notifications to a specified URL when triggered by events (e.g., booking created, cancelled, meeting started). Returns the webhook configuration including its unique ID, which can be used to update or delete the webhook later. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `orgId` | integer | ✅ | `"123"` | Unique identifier for the organization to associate with this webhook. | | `active` | boolean | ✅ | `"true"` | If `true`, webhook is active upon creation and sends notifications; `false` creates it disabled. | | `secret` | string | | `"your_secret_here"` | Secret used to generate an HMAC SHA256 signature for payloads. If provided, Cal.com sends this signature in the `X-Cal-Signature-256` header, allowing `subscriberUrl` to verify request origin. | | `triggers` | array | ✅ | `["BOOKING_CREATED"]` | List of events that trigger this webhook to send a notification to `subscriberUrl`. At least one trigger must be provided. | | `subscriberUrl` | string | ✅ | `"https://example.com/webhook-receiver"` | Publicly accessible URL to receive HTTP POST requests for triggered events; this endpoint must process the webhook payloads. | | `payloadTemplate` | string | | `"{\"event\": \"{{triggerEvent}}\", \"id\": \"{{bookingId}}\"}"` | Optional JSON template for customizing the webhook payload sent to `subscriberUrl`. Supports template variables like `{{triggerEvent}}`, `{{bookingId}}`, `{{type}}`, `{{title}}`, `{{organizer.name}}`, `{{attendees.0.name}}`, etc. If omitted, Cal.com sends a default payload with all event data. | *** ### `Cal Create Or Update Team Profile` Integration name: **CAL\_CREATE\_OR\_UPDATE\_TEAM\_PROFILE** Creates a new team profile, or updates one if a `slug` matches, customizing branding, scheduling, privacy, and operational details. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | ------------------ | ------------------------------------------------------------------------------------------------------------------------------ | | `bio` | string | | — | A short biography or description of the team. | | `name` | string | ✅ | `"Marketing Team"` | The name of the team. | | `slug` | string | | `"marketing-team"` | Unique, URL-friendly identifier for the team. If not provided, may be generated from the name. Used for team page access. | | `theme` | string | | `"light"` | Visual theme for the team's booking page (e.g., `light`, `dark`, `system`). | | `appLogo` | string | | — | Logo URL for the team within the Cal.com application interface. Must be a valid URL or omitted; empty strings are not allowed. | | `logoUrl` | string | | — | URL of the team's primary logo. Must be a valid URL or omitted; empty strings are not allowed. | | `metadata` | object | | — | Custom key-value data associated with the team profile. | | `timeZone` | string | | — | Default timezone for the team, used for initial schedule setup (e.g., Mon-Fri, 9AM-5PM). | | `bannerUrl` | string | | — | URL of the team's banner image for their booking page. Must be a valid URL or omitted; empty strings are not allowed. | | `isPrivate` | boolean | | — | If true, the team profile is private and not publicly discoverable without permissions. | | `weekStart` | string | | `"Sunday"` | Day the week starts for calendar displays (e.g., `Sunday`, `Monday`). | | `brandColor` | string | | `"#FF5733"` | Primary brand color for team pages (hex format, e.g., `#FF5733`). | | `timeFormat` | string | | `"12"` | Preferred time display format: 12 for 12-hour (e.g., 2:30 PM) or 24 for 24-hour (e.g., 14:30). | | `appIconLogo` | string | | — | Icon version URL of the team's logo (e.g., for favicons). Must be a valid URL or omitted; empty strings are not allowed. | | `calVideoLogo` | string | | — | Logo URL for display during the team's Cal.com video calls. Must be a valid URL or omitted; empty strings are not allowed. | | `hideBranding` | boolean | | — | If true, Cal.com's own branding is hidden on the team's public pages. | | `darkBrandColor` | string | | `"#C70039"` | Brand color for dark mode (hex format); complements `brandColor`. | | `autoAcceptCreator` | boolean | | — | If true, the team creator is automatically added and accepted as an admin member. | | `hideBookATeamMember` | boolean | | — | If true, hides the option to book a specific team member, encouraging collective bookings. | *** ### `Cal Create Phone Call Event` Integration name: **CAL\_CREATE\_PHONE\_CALL\_EVENT** Schedules a phone call event in Cal.com using existing eventType, organization, and team IDs; this action only registers the event details and does not initiate the actual phone call. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | | `orgId` | integer | ✅ | — | Unique identifier for an existing organization. | | `teamId` | integer | ✅ | — | Unique identifier for an existing team. | | `calApiKey` | string | ✅ | — | API key for Cal.com integration. | | `guestName` | string | | `"John Smith"` | Name of the guest participating in the call. | | `guestEmail` | string | | `"john.smith@example.com"` | Email address of the guest; can be used for notifications or record-keeping. | | `eventTypeId` | integer | ✅ | — | Unique identifier for an existing event type. | | `beginMessage` | string | | `"This call is regarding your recent inquiry."` | Initial message played or displayed when the call begins; useful for providing context or instructions. | | `guestCompany` | string | | `"Acme Corp"` | Company affiliation of the guest, if applicable. | | `numberToCall` | string | ✅ | `"+13105552368"` | Recipient's phone number in E.164 format (e.g., +13105552368), which will be dialed. | | `templateType` | string | | `"CHECK_IN_APPOINTMENT"` | Template for the phone call event; determines the initial setup and prompts for the call. | | `generalPrompt` | string | | `"Please confirm your availability for the upcoming meeting and discuss any questions you may have."` | General prompt or script to guide the conversation; can set the agenda or provide talking points. | | `schedulerName` | string | | `"Jane Doe"` | Name of the person or entity scheduling the call. | | `yourPhoneNumber` | string | ✅ | `"+12125552368"` | Your phone number in E.164 format (e.g., +12125552368), used as the caller ID. | *** ### `Cal Create Phone Call For Event Type` Integration name: **CAL\_CREATE\_PHONE\_CALL\_FOR\_EVENT\_TYPE** Configures Cal.ai phone call automation for a team event type, enabling AI-powered outbound calls for appointment reminders or custom conversations. Requires team membership - first use `CAL_GET_TEAMS_LIST` to get a valid teamId, then `CAL_GET_EVENT_TYPE_BY_TEAM_ID` or `CAL_RETRIEVE_TEAM_EVENT_TYPES` to get an eventTypeId belonging to that team. Note: This creates the call configuration but does not immediately initiate a call. Cal.ai charges $0.29/minute for AI calls. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `teamId` | integer | ✅ | — | ID of the team that owns the event type. The authenticated user must be a member of this team. Get this from `CAL_GET_TEAMS_LIST`. | | `enabled` | boolean | | — | Whether the phone call configuration is active. Set to true to enable AI calls for this event type. | | `calApiKey` | string | ✅ | `"cal_live_xxxxxxxxxxxx"` | Cal.com API key for the AI phone call integration. This key authorizes the Cal.ai service to make calls on your behalf. | | `guestName` | string | | `"Jane Smith"` | Name of the person being called. The AI will address them by this name during the conversation. | | `guestEmail` | string | | `"jane.smith@example.com"` | Email address of the call recipient. Used for sending follow-up notifications or confirmations. | | `eventTypeId` | integer | ✅ | — | ID of the team event type to associate the phone call with. Must be an event type belonging to the specified team. Get this from `CAL_GET_EVENT_TYPE_BY_TEAM_ID` or `CAL_RETRIEVE_TEAM_EVENT_TYPES`. | | `beginMessage` | string | | `"Hello, this is a courtesy call from Acme Healthcare regarding your upcoming appointment."` | Opening message the AI speaks when the call connects. Use this to set the context and purpose of the call. | | `guestCompany` | string | | `"Acme Corp"` | Company or organization the guest is affiliated with. Provides context for the AI conversation. | | `numberToCall` | string | ✅ | `"+13105552672"` | Recipient's phone number in E.164 format. This is the number the AI will dial to initiate the call. | | `templateType` | string | | `"CHECK_IN_APPOINTMENT"` | Call template type: `CHECK_IN_APPOINTMENT` uses a predefined appointment reminder script, `CUSTOM_TEMPLATE` allows fully customized conversation flow. | | `generalPrompt` | string | | `"Confirm the appointment time, ask if they have any questions, and remind them to bring their insurance card."` | Instructions that guide the AI's conversation behavior throughout the call. Define the tone, objectives, and topics to cover. | | `schedulerName` | string | | `"John Doe Scheduling"` | Name of the person or organization scheduling the call. The AI will use this to introduce itself. | | `yourPhoneNumber` | string | ✅ | `"+14155552671"` | Caller's phone number in E.164 format. This is the number that will appear as the caller ID when the AI makes outbound calls. | *** ### `Cal Create Team Event Type` Integration name: **CAL\_CREATE\_TEAM\_EVENT\_TYPE** Creates a new event type for a specified team in Cal.com; ensure `teamId`, any provided `scheduleId`, `hosts.userId`, and `destinationCalendar` details are valid and accessible. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------------------- | ------- | :------: | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `slug` | string | ✅ | `"team-sync"` | A URL-friendly identifier for the event type, typically derived from the title. | | `hosts` | array | | — | List of specific hosts for this event. Each host needs `userId`. For round-robin, `mandatory` and `priority` can be set. Either provide `hosts` OR set `assignAllTeamMembers=true`, not both. | | `seats` | object | | `"{'perSlot': 10, 'attendeeNoun': 'participant', 'showAttendees': True}"` | Seat-based availability for multiple attendees per slot. | | `title` | string | ✅ | `"Team Sync"` | The title of the event type that will be displayed to bookers. | | `teamId` | integer | ✅ | `"789"` | The unique identifier of the team for which this event type is being created. | | `locations` | array | | `"[{'type': 'integrations:google:meet'}]"` | Event locations (e.g., physical, integration links). Defaults to Cal.com video link. | | `customName` | string | | — | Customizable name for the created calendar event. Supports variables like `{Event type title}`, `{Organiser}`, `{Scheduler}`, etc. | | `recurrence` | object | | `"{'frequency': 'weekly', 'interval': 1, 'byDay': ['MO', 'WE', 'FR']}"` | Recurrence rules for the event. | | `scheduleId` | integer | | — | Overrides team's default schedule with this schedule ID. | | `description` | string | | — | Detailed event type description for bookers. | | `offsetStart` | integer | | — | Offsets start times of available slots by specified minutes. | | `slotInterval` | integer | | — | Duration in minutes for each available time slot. | | `bookingFields` | array | | `"[{'name': 'company_name', 'type': 'text', 'label': 'Company Name', 'required': True}]"` | Custom fields for the booking form (name and email are default). | | `bookingWindow` | object | | `"{'start': 0, 'end': 30, 'unit': 'days'}"` | Future booking window. | | `disableGuests` | boolean | | — | If true, booker cannot add additional guests via email. | | `schedulingType` | string | ✅ | `"collective"` | How bookings are distributed among hosts. `collective`: all hosts must attend. `roundRobin`: distribute bookings across hosts based on availability/priority. `managed`: platform-specific managed scheduling. | | `lengthInMinutes` | integer | ✅ | `"30"` | The default duration of the event in minutes. | | `afterEventBuffer` | integer | | — | Buffer time (minutes) after events (marked unavailable). | | `beforeEventBuffer` | integer | | — | Buffer time (minutes) before events (marked unavailable). | | `hideCalendarNotes` | boolean | | — | If true, hide calendar notes (description, location, etc.) from created event. | | `bookingLimitsCount` | object | | `"{'count': 10, 'period': 'day'}"` | Limits on booking frequency. | | `confirmationPolicy` | object | | `"{'type': 'MANUAL', 'message': 'Your booking requires manual approval.'}"` | Booking confirmation policy. | | `successRedirectUrl` | string | | `"https://example.com/booking-success"` | Redirect URL after successful booking. Defaults to Cal.com page. | | `color__darkThemeHex` | string | | `"#4A90E2"` | Hex color for dark theme display. | | `assignAllTeamMembers` | boolean | | — | If true, assigns all current and future team members as hosts automatically. | | `color__lightThemeHex` | string | | `"#FFD700"` | Hex color for light theme display. | | `minimumBookingNotice` | integer | | — | Minimum minutes notice required for booking. | | `bookingLimitsDuration` | object | | `"{'duration': 120, 'period': 'week'}"` | Limits on total booking duration per period. | | `lengthInMinutesOptions` | array | | `[15,30,45,60]` | Optional alternative event durations that bookers can choose from. | | `hideCalendarEventDetails` | boolean | | — | If true, hide event details (attendees, description) from non-organizer attendees. | | `onlyShowFirstAvailableSlot` | boolean | | — | If true, show only the earliest available slot per day. | | `useDestinationCalendarEmail` | boolean | | — | If true, use destination calendar's email for event invites/updates. | | `destinationCalendar__externalId` | string | | — | External ID for destination calendar. See `/api/v2/calendars`. | | `lockTimeZoneToggleOnBookingPage` | boolean | | — | If true, lock timezone toggle on booking page. | | `requiresBookerEmailVerification` | boolean | | — | If true, bookers must verify email before confirmation. | | `destinationCalendar__integration` | string | | — | Integration type for destination calendar. See `/api/v2/calendars`. | *** ### `Cal Create Team Event Types With Custom Options` Integration name: **CAL\_CREATE\_TEAM\_EVENT\_TYPES\_WITH\_CUSTOM\_OPTIONS** Creates a highly customizable Cal.com team event type with extensive scheduling, booking, and host assignment options; `schedulingType` is required, `lengthInMinutes` must be included in `lengthInMinutesOptions`, destination calendar details (from `/api/v2/calendars`) must be valid if provided, and host User IDs must be valid team members. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------------------- | ------- | :------: | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `slug` | string | ✅ | `"team-sync"` | A URL-friendly identifier for the event type. Usually a hyphenated version of the title. | | `hosts` | array | ✅ | — | List of hosts. Each specifies user ID and optionally mandatory status/priority (for round-robin). At least one host required. | | `orgId` | integer | ✅ | `"12345"` | The unique identifier for the organization. | | `seats` | object | | `"{\"enabled\": true, \"per_slot\": 25, \"show_remaining_seats\": false}"` | Defines seat-based availability, allowing multiple attendees per slot. | | `title` | string | ✅ | `"Team Sync"` | The title of the event type. | | `teamId` | integer | ✅ | `"67890"` | The unique identifier for the team. | | `locations` | array | | `"[{\"type\": \"cal_video\"}]"` | A list of physical or virtual locations for the event. If not provided, a Cal.com video link will be used by default. | | `customName` | string | | `"{Event type title} with {Scheduler}"` | Customizable name for the calendar event entry. | | `recurrence` | object | | `"{\"frequency\": \"weekly\", \"interval\": 1, \"days\": [1,3,5], \"count\": 4}"` | Defines the recurrence pattern for recurring events. | | `scheduleId` | integer | | `"987"` | The ID of a specific schedule to use for this event type, overriding the team's or user's default schedule. | | `description` | string | | `"Weekly synchronization meeting for the development team."` | A detailed description of the event type. Can include HTML for formatting. | | `offsetStart` | integer | | `"0"` | Offset (minutes) to shift display of available slots. | | `slotInterval` | integer | | `"15"` | Duration in minutes of each bookable time slot. | | `bookingFields` | array | | `"[{\"name\": \"project_id\", \"label\": \"Project ID\", \"type\": \"text\", \"required\": true}]"` | A list of custom fields for the booking form. | | `bookingWindow` | object | | `"{\"type\": \"rolling_days\", \"days\": 60}"` | Defines how far in the future this event can be booked. | | `disableGuests` | boolean | | — | If true, the person booking this event cannot add guests via their email addresses. | | `schedulingType` | string | ✅ | `"COLLECTIVE"` | How bookings are distributed among hosts. `COLLECTIVE`: all hosts must attend. `ROUND_ROBIN`: distribute bookings across hosts based on availability/priority. `MANAGED`: platform-specific managed scheduling. | | `lengthInMinutes` | integer | ✅ | `"30"` | The default duration of the event in minutes. | | `afterEventBuffer` | integer | | `"5"` | Buffer time in minutes to add after each event. | | `beforeEventBuffer` | integer | | `"5"` | Buffer time in minutes to add before each event. | | `hideCalendarNotes` | boolean | | — | If true, any notes added to the calendar event by the organizer will be hidden from the booker. | | `bookingLimitsCount` | object | | `"{\"period\": \"day\", \"count\": 1}"` | Defines limits on how many times this event can be booked per period. | | `confirmationPolicy` | object | | `"{\"type\": \"automatic_confirmation\"}"` | Specifies the manual confirmation policy for bookings. | | `successRedirectUrl` | string | | `"https://example.com/thank-you"` | A valid URL to which the booker will be redirected after a successful booking. | | `color__darkThemeHex` | string | | `"#50E3C2"` | Hexadecimal color code for the event type when displayed in a dark theme. | | `assignAllTeamMembers` | boolean | | — | If true, all current and future members of the team will automatically be assigned as hosts to this event type. | | `color__lightThemeHex` | string | | `"#4A90E2"` | Hexadecimal color code for the event type when displayed in a light theme. | | `minimumBookingNotice` | integer | | `"60"` | The minimum number of minutes before the event's start time that a booking can be made. | | `bookingLimitsDuration` | object | | `"{\"period\": \"day\", \"duration\": 60}"` | Defines limits on total booked duration (minutes) for this event type per period. | | `lengthInMinutesOptions` | array | ✅ | `[30,60]` | Alternative event durations (in minutes) that bookers can choose from. The value of `lengthInMinutes` must be included in this list. | | `hideCalendarEventDetails` | boolean | | — | If true, sensitive details of the calendar event may be hidden or summarized for bookers. | | `onlyShowFirstAvailableSlot` | boolean | | — | If true, only the earliest available slot per day will be displayed to bookers for this event type. | | `useDestinationCalendarEmail` | boolean | | — | If true, the email address associated with the destination calendar will be used for sending event notifications. | | `destinationCalendar__externalId` | string | | `"primary"` | External ID of the specific calendar for new bookings. | | `lockTimeZoneToggleOnBookingPage` | boolean | | — | If true, the booker will not be able to change the timezone on the booking page. | | `requiresBookerEmailVerification` | boolean | | — | If true, bookers will be required to verify their email address before the booking is confirmed. | | `destinationCalendar__integration` | string | | `"google_calendar"` | Integration type of the calendar for new bookings. | *** ### `Cal Create Team In Organization` Integration name: **CAL\_CREATE\_TEAM\_IN\_ORGANIZATION** Creates a new team with customizable attributes within an existing and accessible Cal.com organization specified by orgId. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `bio` | string | | `"The core engineering team focused on platform development."` | Short description or biography for the team. | | `name` | string | ✅ | `"Marketing Team"` | Name of the team to be created. | | `slug` | string | | `"marketing-team-alpha"` | Unique, URL-friendly identifier for the team (e.g., `marketing-team`). Auto-generated from name if not provided. | | `orgId` | integer | ✅ | — | ID of the organization where the team will be created. | | `theme` | string | | `"light"` | Visual theme for the team's booking page (e.g., `light`, `dark`, `system`, or custom). | | `appLogo` | string | | `"https://example.com/logos/app-logo.png"` | URL for the logo displayed within the Cal.com application interface for this team. | | `logoUrl` | string | | `"https://example.com/logos/team-logo.png"` | URL of the team's logo image, displayed on its booking page and profile. | | `metadata` | string | | `"{\"internal_id\": \"team_alpha_007\", \"region\": \"EMEA\", \"slack_channel\": \"#team-alpha\"}"` | JSON string for custom key-value pairs to store additional team information. NOTE: This parameter may not be supported by the API and can cause 400 errors. The API documentation indicates this should be an object with up to 50 keys. Recommended to leave as default (None). | | `timeZone` | string | | `"America/Los_Angeles"` | IANA time zone identifier for the team's default schedule. Defaults to `Europe/London`. | | `bannerUrl` | string | | `"https://example.com/banners/team-banner.jpg"` | URL of the team's banner image, displayed at the top of its booking page. | | `isPrivate` | boolean | | — | If true, the team is private, not publicly discoverable, and access is restricted. | | `weekStart` | string | | `"Sunday"` | First day of the week for calendar displays. | | `brandColor` | string | | `"#3498db"` | Primary brand color for the team. | | `timeFormat` | integer | | `12` | Preferred time format. NOTE: This parameter may not be supported by the API and can cause 400 errors. Recommended to leave as default (None). | | `appIconLogo` | string | | `"https://example.com/logos/app-icon.ico"` | URL for a smaller icon version of the team's logo for contexts like list views or notifications. | | `calVideoLogo` | string | | `"https://example.com/logos/team-video-logo.mp4"` | URL for the team's video logo, displayed during Cal Video sessions. | | `hideBranding` | boolean | | — | If true, hides Cal.com's default branding on the team's booking pages for a white-labeled experience. | | `darkBrandColor` | string | | `"#1A202C"` | Brand color for dark theme on the team's booking page. | | `autoAcceptCreator` | boolean | | — | If true, the team creator is automatically accepted as a member. Defaults to true. WARNING: Setting this to false may cause 400 errors. Platform customers should not set this to false. | | `hideBookATeamMember` | boolean | | — | If true, hides the option to book a specific team member from the team's main booking page. | *** ### `Cal Create Team Invite Link` Integration name: **CAL\_CREATE\_TEAM\_INVITE\_LINK** Creates a shareable invite link for a Cal.com team that allows new members to join. Returns both the raw token and a complete invitation URL. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | -------- | ---------------------------------------------------------------------------------------------------------------------------- | | `teamId` | integer | ✅ | `184336` | Unique identifier of the team to create an invite link for. The authenticated user must have permission to manage this team. | *** ### `Cal Create Team Membership With Role` Integration name: **CAL\_CREATE\_TEAM\_MEMBERSHIP\_WITH\_ROLE** Adds a user to a team with a specified role, acceptance status, and impersonation settings; ensure `teamId` and `userId` refer to existing, valid entities. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | `role` | string | | `"MEMBER"` | The role to assign to the user within the team. | | `teamId` | integer | ✅ | — | The unique identifier of the team to which the user will be added. | | `userId` | integer | ✅ | — | The unique identifier of the user to be added to the team. | | `accepted` | boolean | | — | Indicates if the membership invitation is pre-accepted. If `true`, the user is added directly to the team without needing to accept an invitation. | | `disableImpersonation` | boolean | | — | If `true`, prevents administrators from impersonating this user. | *** ### `Cal Create User Availability Schedule` Integration name: **CAL\_CREATE\_USER\_AVAILABILITY\_SCHEDULE** Creates a Cal.com user availability schedule, defining its name, timezone, weekly recurring availability, and specific date overrides; if `isDefault` is true, this schedule replaces any existing default and applies to event types not linked to a specific schedule. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"Standard Work Week"` | Descriptive name for the availability schedule (e.g., `Working Hours`, `Holiday Schedule`). | | `timeZone` | string | ✅ | `"America/Los_Angeles"` | IANA timezone identifier (e.g., `America/New_York`). Essential for correct event availability calculation. | | `isDefault` | boolean | ✅ | — | Sets this as the user's default schedule if true, replacing any existing default. The default schedule is used for event types not linked to a specific one. Each user must have exactly one default schedule. | | `overrides` | array | | — | List of override objects for specific date exceptions (e.g., holidays). Overrides take precedence over weekly availability. | | `availability` | array | | — | List of availability objects defining active days and time slots. If omitted, a default (Mon-Fri, 09:00-17:00 in schedule's timeZone) is applied. | *** ### `Cal Create User Schedule In Organization` Integration name: **CAL\_CREATE\_USER\_SCHEDULE\_IN\_ORGANIZATION** Creates a new schedule defining a user's availability with weekly slots and date-specific overrides in an organization; setting `isDefault` to true may replace an existing default schedule for the user. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"Working Hours"` | Descriptive name for the schedule. | | `orgId` | integer | ✅ | — | Unique identifier of the organization. | | `userId` | integer | ✅ | — | Unique identifier of the user for whom the schedule is created. | | `timeZone` | string | ✅ | `"America/New_York"` | IANA timezone identifier for the schedule; used to calculate event times. | | `isDefault` | boolean | ✅ | — | Specifies if this is the user's default schedule. Only one schedule can be default; used for event types not tied to a specific schedule. | | `overrides` | array | | — | List of overrides to change availability for specific dates (e.g., holidays, special events). | | `availability` | array | | — | List of availability objects defining the user's regular weekly schedule. If omitted, system may assume a default (e.g., Mon-Fri, 09:00-17:00). | *** ### `Cal Create Webhook For Event Type` Integration name: **CAL\_CREATE\_WEBHOOK\_FOR\_EVENT\_TYPE** Creates a webhook for an existing `eventTypeId` in Cal.com, sending notifications for specified `triggers` to a `subscriberUrl` that handles POST requests. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | `active` | boolean | ✅ | `"true"` | Indicates if the webhook is active. | | `secret` | string | | `"your_secret_here"` | Secret key to sign the webhook payload, allowing verification of Cal.com origin. | | `triggers` | array | ✅ | `["BOOKING_CREATED"]` | List of events that trigger the webhook. At least one trigger must be provided. | | `eventTypeId` | integer | ✅ | `"123"` | Unique identifier for the event type. | | `subscriberUrl` | string | ✅ | `"https://api.example.com/webhooks/cal"` | URL to receive webhook payloads for trigger events; must handle POST requests. | | `payloadTemplate` | string | | `"{\"event_type\": \"{{type}}\", \"booking_id\": \"{{uid}}\", \"attendee_email\": \"{{attendee.email}}\"}"` | String template for the payload sent to `subscriberUrl`, allowing variables like `{{type}}`. | *** ### `Cal Decline Booking With Reason` Integration name: **CAL\_DECLINE\_BOOKING\_WITH\_REASON** Declines a pending booking using its bookingUid, optionally with a reason; this action is irreversible and applies only to bookings awaiting confirmation. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ----------------------------------- | ------------------------------------------------------------------------------------------------------------- | | `reason` | string | | `"Unexpected scheduling conflict."` | Reason provided by the host for declining the booking; recommended for clear communication with the attendee. | | `bookingUid` | string | ✅ | `"bk_123abc456xyz"` | The unique identifier (UID) of the booking to be declined. | *** ### `Cal Delete All Team Event Type Webhooks` Integration name: **CAL\_DELETE\_ALL\_TEAM\_EVENT\_TYPE\_WEBHOOKS** Permanently deletes all webhooks associated with a specific team event type. Use when you need to remove all webhook configurations for a team's event type. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | --------- | --------------------------------------------------------------------------------- | | `teamId` | integer | ✅ | `184336` | The unique numeric identifier of the team that owns the event type. | | `eventTypeId` | integer | ✅ | `4591148` | The unique numeric identifier of the event type whose webhooks should be deleted. | *** ### `Cal Delete Conference App Connection` Integration name: **CAL\_DELETE\_CONFERENCE\_APP\_CONNECTION** Disconnects the specified conferencing application (e.g., `zoom`, `google_meet`) for the Cal.com account, immediately terminating any ongoing call or meeting; use with caution. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | -------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `app` | string | ✅ | `"zoom"` | Identifier for the conferencing application to be disconnected. This is typically the unique name or slug of the app integration in Cal.com. | *** ### `Cal Delete Destination Calendar By Id` Integration name: **CAL\_DELETE\_DESTINATION\_CALENDAR\_BY\_ID** Tool to remove an existing destination calendar by its unique ID. Use when you need to delete a destination calendar configuration. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | --------- | ------------------------------------------------------------ | | `id` | integer | ✅ | `1085730` | The unique identifier of the destination calendar to delete. | *** ### `Cal Delete Event Type By Id` Integration name: **CAL\_DELETE\_EVENT\_TYPE\_BY\_ID** Permanently deletes an existing event type by its ID, which invalidates its scheduling links; the operation is irreversible, and while existing bookings are unaffected, no new bookings can be made for this event type. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------- | ---------------------------------------------------------------- | | `eventTypeId` | integer | ✅ | `"123"` | The unique numerical identifier of the event type to be deleted. | *** ### `Cal Delete Event Type In Team` Integration name: **CAL\_DELETE\_EVENT\_TYPE\_IN\_TEAM** Permanently removes an event type's configuration from a team's scheduling options (e.g., for cleanup); this action is irreversible and requires the event type to be associated with the team. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------- | --------------------------------------------------------------------------------------- | | `teamId` | integer | ✅ | — | The unique identifier for the team from which the event type will be deleted. | | `eventTypeId` | integer | ✅ | — | The unique identifier for the event type that is to be deleted from the specified team. | *** ### `Cal Delete Membership In Team` Integration name: **CAL\_DELETE\_MEMBERSHIP\_IN\_TEAM** Use to permanently remove a user's membership from a specific team within an organization, which revokes their team-associated access but does not remove them from the organization. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ------- | ----------------------------------------------------------------------------- | | `orgId` | integer | ✅ | `123` | The unique identifier for the organization in which the team resides. | | `teamId` | integer | ✅ | `101` | The unique identifier for the team from which the membership will be deleted. | | `membershipId` | integer | ✅ | `111` | The unique identifier for the membership entry to be deleted. | *** ### `Cal Delete Oauth Client User` Integration name: **CAL\_DELETE\_OAUTH\_CLIENT\_USER** Permanently removes a managed user's association with an OAuth client without deleting their Cal.com account. This is a Cal.com Platform API endpoint for developers who manage users through OAuth clients. Prerequisites: - A registered OAuth client application (provides clientId) - The OAuth client secret key (`x_cal_secret_key`) - A valid managed user ID that was created under this OAuth client The deleted user's information is returned in the response for confirmation. Note: This endpoint is marked as deprecated in Cal.com docs but remains functional for existing Platform customers. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------- | :------: | ---------------------------------------- | -------------------------------------------------------------- | | `userId` | integer | ✅ | `12345` | The unique numerical identifier of the managed user to delete. | | `clientId` | string | ✅ | `"a1b2c3d4-e5f6-7890-1234-567890abcdef"` | The unique identifier of the OAuth client application. | | `x_cal_secret_key` | string | ✅ | `"cal_secret_abc123xyz"` | The OAuth client secret key for authentication. | *** ### `Cal Delete Oauth Client Webhook` Integration name: **CAL\_DELETE\_OAUTH\_CLIENT\_WEBHOOK** Permanently deletes a specific webhook for an OAuth client in Cal.com Platform API. This endpoint is part of the Cal.com Platform API and requires valid OAuth client credentials. When a webhook is deleted, it will stop receiving notifications for all configured event triggers. **Prerequisites:** - A Platform-enabled Cal.com organization (requires `isPlatform: true`) - Valid OAuth client credentials (`clientId` and `x_cal_secret_key`) - An existing webhook created for the OAuth client **Typical Use Case:** Remove webhook subscriptions that are no longer needed, helping to manage and clean up your OAuth client's notification endpoints. **Note:** This endpoint is marked as deprecated in Cal.com documentation and may be removed in future versions. Consider using alternative webhook management endpoints when available. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------ | :------: | ----------------------------- | ----------------------------------------------------------------- | | `clientId` | string | ✅ | `"clsx38nbl0001vkhlwin9fmt0"` | Unique identifier of the OAuth client. | | `webhookId` | string | ✅ | `"wh_9z8y7x6w5v4u3t2s"` | Unique identifier of the webhook to be deleted. | | `x_cal_secret_key` | string | ✅ | `"cal_secret_abc123xyz"` | The OAuth client secret key required for Platform authentication. | *** ### `Cal Delete Organization Attribute` Integration name: **CAL\_DELETE\_ORGANIZATION\_ATTRIBUTE** Permanently deletes an existing attribute (specified by `attributeId`) from an existing organization (specified by `orgId`); this action is irreversible and may affect features dependent on the attribute. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------------------- | ------------------------------------------------------------- | | `orgId` | integer | ✅ | `12345` | The unique numeric identifier of the organization. | | `attributeId` | string | ✅ | `"clx123abc456def"` | The unique string identifier (ID) of the attribute to delete. | *** ### `Cal Delete Organization Attribute Option` Integration name: **CAL\_DELETE\_ORGANIZATION\_ATTRIBUTE\_OPTION** Permanently deletes a specified option from an organization's attribute. Use this action to remove an option value from attributes of type `SINGLE_SELECT` or `MULTI_SELECT`. This is useful for cleaning up unused or deprecated configuration choices. Note: This action is destructive and cannot be undone. The option will be permanently removed. Requires organization admin access. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | --------------- | --------------------------------------------------------------- | | `orgId` | integer | ✅ | `1001` | The unique numeric identifier of the organization. | | `optionId` | string | ✅ | `"opt_abc123"` | The unique identifier of the option to delete. | | `attributeId` | string | ✅ | `"clp1234abcd"` | The unique identifier of the attribute within the organization. | *** ### `Cal Delete Organization Membership` Integration name: **CAL\_DELETE\_ORGANIZATION\_MEMBERSHIP** Irreversibly deletes a user's membership from an organization, removing all associated access and permissions; the response confirms deletion without returning details of the deleted membership. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------ | | `orgId` | integer | ✅ | `123` | The unique identifier of the organization from which the membership will be removed. | | `membershipId` | integer | ✅ | `789` | The unique identifier of the membership to be deleted. | *** ### `Cal Delete Org Webhook` Integration name: **CAL\_DELETE\_ORG\_WEBHOOK** Permanently deletes an organization-level webhook by its ID. This action removes the specified webhook from the organization, stopping all future notifications to its subscriber URL. The deletion is irreversible - the webhook configuration cannot be recovered after deletion. Requirements: - User must be authenticated and have admin permissions in the organization - The webhook must exist within the specified organization - Use `retrieve_organization_webhooks_by_org_id` to list webhooks before deletion #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | ---------------------------------------- | ---------------------------------------------------------------- | | `orgId` | integer | ✅ | `12345` | The unique identifier of the organization that owns the webhook. | | `webhookId` | string | ✅ | `"d7ffbce3-4768-41be-b976-a004bbb5b0c4"` | The unique identifier of the webhook to be deleted. | *** ### `Cal Delete Schedule By Id` Integration name: **CAL\_DELETE\_SCHEDULE\_BY\_ID** Permanently deletes a specific schedule using its unique identifier, which must correspond to an existing schedule. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------- | ---------------------------------------------------- | | `scheduleId` | integer | ✅ | `"123"` | The unique identifier of the schedule to be deleted. | *** ### `Cal Delete Selected Calendars` Integration name: **CAL\_DELETE\_SELECTED\_CALENDARS** Removes a specified, currently selected calendar from the user's active list within the application, without deleting it from the external provider. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------ | :------: | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `externalId` | string | ✅ | — | The unique identifier of the calendar as recognized by the external integration provider (e.g., a Google Calendar ID or an Outlook Calendar primary key). | | `integration` | string | ✅ | `"google_calendar"` | Identifier for the calendar integration provider, specifying the type of the external calendar system. | | `credentialId` | string | ✅ | — | The unique identifier for the set of credentials used to authenticate and access the specified calendar integration for this user. | *** ### `Cal Delete Selected Slot` Integration name: **CAL\_DELETE\_SELECTED\_SLOT** Deletes a previously selected time slot from the Cal schedule using its `uid`; the slot must exist and this action is irreversible. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ------------------- | ----------------------------------------------------------- | | `uid` | string | ✅ | `"slot_uid_1a2b3c"` | The unique identifier (UID) of the time slot to be deleted. | *** ### `Cal Delete Team By Id` Integration name: **CAL\_DELETE\_TEAM\_BY\_ID** Permanently and irreversibly deletes an existing team and all its associated data from the Cal system, using the team's unique `teamId`. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ------------------------------------------------ | | `teamId` | integer | ✅ | `"123"` | The unique identifier of the team to be deleted. | *** ### `Cal Delete Team Event Type In Organization` Integration name: **CAL\_DELETE\_TEAM\_EVENT\_TYPE\_IN\_ORGANIZATION** Permanently removes a team event type from an organization's scheduling configuration. Use when cleaning up unused event types or consolidating team scheduling options. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | --------- | ----------------------------------------------------------------------------------------------- | | `orgId` | integer | ✅ | `184337` | The unique identifier of the organization containing the team whose event type will be deleted. | | `teamId` | integer | ✅ | `184336` | The unique identifier of the team from which the event type will be deleted. | | `eventTypeId` | integer | ✅ | `4590968` | The unique identifier of the event type to be deleted from the specified team. | *** ### `Cal Delete Team From Organization` Integration name: **CAL\_DELETE\_TEAM\_FROM\_ORGANIZATION** Permanently and irreversibly deletes a specific team from a Cal.com organization. WARNING: This action cannot be undone and will remove all associated team data including memberships, event types, and bookings. Requires ORG\_ADMIN role in the organization. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ------------------------------------------------------------------------------ | | `orgId` | integer | ✅ | `12345` | The unique numeric identifier of the Cal.com organization containing the team. | | `teamId` | integer | ✅ | `11111` | The unique numeric identifier of the team to be permanently deleted. | *** ### `Cal Delete Team Memberships By Id` Integration name: **CAL\_DELETE\_TEAM\_MEMBERSHIPS\_BY\_ID** Irreversibly removes a user's team membership in the Cal application, revoking access to that specific team; the user's overall Cal account remains active. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ------- | ---------------------------------------------------------------------------- | | `teamId` | integer | ✅ | `"123"` | The unique identifier of the team from which the membership will be removed. | | `membershipId` | integer | ✅ | `"789"` | The unique identifier of the specific team membership record to be deleted. | *** ### `Cal Delete User Attribute Option` Integration name: **CAL\_DELETE\_USER\_ATTRIBUTE\_OPTION** Unassigns a specific attribute option from a user within an organization. Use this action to remove an attribute option assignment (e.g., skill, role, department) from a specific user. This does NOT delete the attribute option itself from the organization - it only removes the association between the user and that option. The attribute option must currently be assigned to the user. To find assigned attribute options for a user, use the `Get all attribute options for a user` endpoint first. Requires organization admin access. The operation is reversible by re-assigning the attribute option to the user using the `Assign attribute option to user` endpoint. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | --------------- | -------------------------------------------------------------------------------------------- | | `orgId` | integer | ✅ | `1001` | The unique numeric identifier of the organization. | | `userId` | integer | ✅ | `2090888` | The unique numeric identifier of the user from whom the attribute option will be unassigned. | | `attributeOptionId` | string | ✅ | `"clp1234abcd"` | The unique identifier of the attribute option to unassign from the user. | *** ### `Cal Delete User From Organization` Integration name: **CAL\_DELETE\_USER\_FROM\_ORGANIZATION** Permanently removes a user from a specific organization (user's system-wide account is unaffected), revoking their access rights therein; this action is irreversible via API and expects the user to be a current member. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ------------------------------------------------------------------------------ | | `orgId` | integer | ✅ | — | The unique identifier of the organization from which the user will be removed. | | `userId` | integer | ✅ | — | The unique identifier of the user to be removed from the organization. | *** ### `Cal Delete User Schedule` Integration name: **CAL\_DELETE\_USER\_SCHEDULE** Permanently deletes a specific user's schedule, provided the organization, user, and schedule (identified by `orgId`, `userId`, and `scheduleId`) exist. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------- | ----------------------------------------------------------------- | | `orgId` | integer | ✅ | `1001` | Specifies the organization to which the user and schedule belong. | | `userId` | integer | ✅ | `500` | Specifies the user whose schedule is to be deleted. | | `scheduleId` | integer | ✅ | `90012` | Specifies the schedule to be deleted. | *** ### `Cal Delete Webhook By Id` Integration name: **CAL\_DELETE\_WEBHOOK\_BY\_ID** Permanently deletes an existing webhook by its `webhookId`, stopping future notifications; this action is irreversible. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | -------------------------------- | --------------------------------------------------- | | `webhookId` | string | ✅ | `"wh_clq0f3x7x000108ju3fx7g7z1"` | The unique identifier of the webhook to be deleted. | *** ### `Cal Delete Webhook For Event Type` Integration name: **CAL\_DELETE\_WEBHOOK\_FOR\_EVENT\_TYPE** Permanently deletes a specific webhook for an event type, halting its real-time notifications; this operation is irreversible and leaves the event type and other webhooks untouched. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------------- | ------------------------------------------------------------------------------- | | `webhookId` | string | ✅ | `"wh_abc123"` | The unique identifier of the webhook configuration to be deleted. | | `eventTypeId` | integer | ✅ | `"123"` | The unique identifier of the event type from which the webhook will be deleted. | *** ### `Cal Delete Webhooks For Event Type` Integration name: **CAL\_DELETE\_WEBHOOKS\_FOR\_EVENT\_TYPE** Call this to irreversibly delete all webhooks for a specific `eventTypeId` if the event type exists; details of deleted webhooks are not returned. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------ | | `eventTypeId` | integer | ✅ | `"123"` | The unique identifier of the event type for which all associated webhooks will be deleted. | *** ### `Cal Disconnect Calendar Using Credential Id` Integration name: **CAL\_DISCONNECT\_CALENDAR\_USING\_CREDENTIAL\_ID** Disconnects a calendar integration by its provider name and credential ID, irreversibly revoking Cal's access; external calendar data remains unaffected. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | integer | ✅ | `"12345"` | Unique numeric credential ID for the calendar integration to be disconnected. | | `calendar` | string | ✅ | `"google"` | Identifier for the calendar to be disconnected, typically the provider name (e.g., `google`, `outlook`) or a service-specific calendar name. | *** ### `Cal Edit Attendee By Id` Integration name: **CAL\_EDIT\_ATTENDEE\_BY\_ID** Tool to edit an existing attendee in a Cal.com booking. Use when you need to update attendee details such as name, email, or timezone. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | ------------------------- | -------------------------------------------------------------------- | | `id` | integer | ✅ | `17601482` | ID of the attendee to edit. | | `name` | string | | `"Updated Test User V2"` | The attendee's name. | | `email` | string | | `"test.user@example.com"` | The attendee's email address. | | `timeZone` | string | | `"America/Chicago"` | The attendee's timezone in IANA Time Zone Database format. | | `bookingId` | integer | ✅ | `15100618` | The booking ID associated with the attendee. This field is required. | *** ### `Cal Edit Availability By Id` Integration name: **CAL\_EDIT\_AVAILABILITY\_BY\_ID** Tool to edit an existing availability by ID on Cal.com. Use when you need to update the days, start time, end time, or schedule association of an existing availability. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `id` | integer | ✅ | `41737395` | ID of the availability to edit | | `days` | array | | `[1,2,3,4]` | Array of integers depicting weekdays (`0=Sunday`, `1=Monday`, `2=Tuesday`, `3=Wednesday`, `4=Thursday`, `5=Friday`, `6=Saturday`). | | `endTime` | string | | `"1970-01-01T16:00:00.000Z"` | End time of the availability in ISO 8601 datetime format. | | `startTime` | string | | `"1970-01-01T10:00:00.000Z"` | Start time of the availability in ISO 8601 datetime format. | | `scheduleId` | integer | | `123456` | ID of schedule this availability is associated with | *** ### `Cal Edit Booking By Id` Integration name: **CAL\_EDIT\_BOOKING\_BY\_ID** Tool to edit an existing booking by its ID. Use when you need to update booking details such as title, description, status, or time. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ----------------------------------------- | ---------------------------------------------------- | | `id` | integer | ✅ | `15100670` | ID of the booking to edit | | `end` | string | | `"2024-06-15T11:00:00Z"` | End time of the event in ISO 8601 date-time format | | `start` | string | | `"2024-06-15T10:00:00Z"` | Start time of the event in ISO 8601 date-time format | | `title` | string | | `"Updated Meeting Title"` | Booking event title | | `status` | string | | `"ACCEPTED"` | Status values for a booking. | | `description` | string | | `"This meeting has been updated via API"` | Description of the meeting | *** ### `Cal Edit Event Type By Id` Integration name: **CAL\_EDIT\_EVENT\_TYPE\_BY\_ID** Tool to edit an existing Cal.com event type by ID. Use when you need to update event type settings like title, description, duration, locations, or booking configurations. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------------- | ------- | :------: | ------------------------------- | ----------------------------------------------------------------------------------------- | | `id` | integer | ✅ | `4518235` | ID of the eventType to edit | | `slug` | string | | `"30min"` | Unique slug for the event type | | `hosts` | array | | — | List of hosts for team event types | | `price` | integer | | — | Price of the event type booking | | `title` | string | | `"30 Minute Meeting"` | Title of the event type | | `hidden` | boolean | | — | If the event type should be hidden from your public booking page | | `length` | integer | | `30` | Duration of the event type in minutes | | `teamId` | integer | | — | Team ID if the event type should belong to a team | | `currency` | string | | `"usd"` | Currency acronym. Eg- usd, eur, gbp, etc. | | `metadata` | object | | — | Metadata relating to event type. Pass `{}` if empty. | | `position` | integer | | — | The position of the event type on the public booking page | | `locations` | array | | — | A list of all available locations for the event type. | | `periodDays` | integer | | — | Number of bookable days (Required if periodType is rolling) | | `periodType` | string | | — | Period type for bookable event range. | | `scheduleId` | integer | | — | The ID of the schedule for this event type | | `description` | string | | `"A quick 30 minute meeting"` | Description of the event type | | `slotInterval` | integer | | — | The intervals of available bookable slots in minutes | | `disableGuests` | boolean | | — | If the event type should disable adding guests to the booking | | `periodEndDate` | string | | `"2024-12-31T23:59:59Z"` | End date of bookable period (Required if periodType is `range`) | | `recurringEvent` | object | | — | Recurring event configuration. | | `schedulingType` | string | | — | Scheduling type for team events. | | `periodStartDate` | string | | `"2024-01-01T00:00:00Z"` | Start date of bookable period (Required if periodType is `range`) | | `afterEventBuffer` | integer | | — | Number of minutes of buffer time after a Cal Event | | `seatsPerTimeSlot` | integer | | — | The number of seats for each time slot | | `beforeEventBuffer` | integer | | — | Number of minutes of buffer time before a Cal Event | | `hideCalendarNotes` | boolean | | — | If the calendar notes should be hidden from the booking | | `seatsShowAttendees` | boolean | | — | Share attendee information in seats | | `successRedirectUrl` | string | | `"https://example.com/success"` | A valid URL where the booker will redirect to, once the booking is completed successfully | | `minimumBookingNotice` | integer | | — | Minimum time in minutes before the event is bookable | | `requiresConfirmation` | boolean | | — | If the event type should require your confirmation before completing the booking | | `periodCountCalendarDays` | boolean | | — | If calendar days should be counted for period days | | `seatsShowAvailabilityCount` | boolean | | — | Show the number of available seats | *** ### `Cal Edit Selected Calendar By Id` Integration name: **CAL\_EDIT\_SELECTED\_CALENDAR\_BY\_ID** Tool to edit a selected calendar by its composite ID in Cal.com. Use when you need to update an existing calendar integration. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ----------------------------- | ----------------------------------------------------------- | | `user_id` | integer | ✅ | `2090888` | User ID of the selected calendar to edit. | | `external_id` | string | ✅ | `"partnerships@composio.dev"` | External calendar identifier from the integration provider. | | `integration` | string | ✅ | `"google_calendar"` | Integration provider of the calendar. | | `new_external_id` | string | | `"new_calendar@example.com"` | New external calendar identifier. | | `new_integration` | string | | `"google_calendar"` | New integration provider to set for this calendar. | | `new_credential_id` | integer | | `101` | New credential ID to associate with this calendar. | *** ### `Cal Fetch All Bookings` Integration name: **CAL\_FETCH\_ALL\_BOOKINGS** Fetches a list of bookings, optionally filtered by status, attendee, date range, or by event/team IDs (which must belong to/include the authenticated user respectively), with support for pagination and sorting. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------- | :------: | ------------------------ | ---------------------------------------------------------------------- | | `skip` | integer | | `"0"` | Number of bookings to skip from the beginning of results. | | `take` | integer | | `"10"` | Maximum number of bookings to return. | | `status` | array | | `["upcoming","past"]` | Filter bookings by status. | | `teamId` | integer | | `123` | Filter bookings by a single team ID of which the user is a member. | | `sortEnd` | string | | `"asc"` | Sort results by booking end time. | | `teamsIds` | string | | `"123,456"` | Filter bookings by one or more team IDs of which the user is a member. | | `beforeEnd` | string | | `"2024-12-31"` | Filter bookings ending before this ISO 8601 date or date-time string. | | `sortStart` | string | | `"asc"` | Sort results by booking start time. | | `afterStart` | string | | `"2024-01-01"` | Filter bookings starting after this ISO 8601 date or date-time string. | | `eventTypeId` | integer | | `123` | Filter bookings by a single event type ID belonging to the user. | | `sortCreated` | string | | `"asc"` | Sort results by booking creation time. | | `attendeeName` | string | | `"John Doe"` | Filter bookings by the name of an attendee. | | `eventTypeIds` | string | | `"123,456"` | Filter bookings by one or more event type IDs belonging to the user. | | `attendeeEmail` | string | | `"john.doe@example.com"` | Filter bookings by the exact email address of an attendee. | *** ### `Cal Fetch Event Type Details` Integration name: **CAL\_FETCH\_EVENT\_TYPE\_DETAILS** Fetches all configuration settings and characteristics for a single event type (identified by orgId, teamId, and eventTypeId), which must exist and be accessible; this read-only action cannot list, create, or modify event types. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | --------- | ------------------------------------------------------------------------------------------------------ | | `orgId` | integer | ✅ | `"12345"` | The unique identifier of the organization to which the event type belongs. | | `teamId` | integer | ✅ | `"67890"` | The unique identifier of the team, within the specified organization, to which the event type belongs. | | `eventTypeId` | integer | ✅ | `"11223"` | The unique identifier of the specific event type for which details are to be fetched. | *** ### `Cal Fetch Organization Attribute By Id` Integration name: **CAL\_FETCH\_ORGANIZATION\_ATTRIBUTE\_BY\_ID** Retrieves a specific attribute of an organization, useful for fetching a single data point instead of the entire organization record. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ---------------------------------------- | ---------------------------------------------------- | | `orgId` | integer | ✅ | `"12345"` | The unique numerical identifier of the organization. | | `attributeId` | string | ✅ | `"1eed080a-36d4-4e51-bdee-b7debe2786f4"` | The UUID of the custom attribute to retrieve. | *** ### `Cal Fetch Provider Access Token` Integration name: **CAL\_FETCH\_PROVIDER\_ACCESS\_TOKEN** Fetches an OAuth access token for the specified `clientId` to authenticate API calls; this action only retrieves the token, not managing scheduling or calendar events. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ------------------------ | --------------------------------------------------------------------------------------- | | `clientId` | string | ✅ | `"cal_oauth_client_123"` | The unique identifier of the OAuth client application registered with Cal.com Platform. | *** ### `Cal Fetch Schedule By Id` Integration name: **CAL\_FETCH\_SCHEDULE\_BY\_ID** Fetches comprehensive details for a specific, existing schedule using its `scheduleId`. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------- | ---------------------------------------------- | | `scheduleId` | integer | ✅ | `12345` | Unique identifier of the schedule to retrieve. | *** ### `Cal Fetch User Schedule By Org Id` Integration name: **CAL\_FETCH\_USER\_SCHEDULE\_BY\_ORG\_ID** Retrieves a specific user's schedule within an organization, returning availability windows, timezone settings, and date-specific overrides. Requires organization-level access permissions. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------- | -------------------------------------------------------------------- | | `orgId` | integer | ✅ | `12345` | The unique identifier of the organization. | | `userId` | integer | ✅ | `2090888` | The unique identifier of the user whose schedule is being retrieved. | | `scheduleId` | integer | ✅ | `1199397` | The unique identifier of the specific schedule to retrieve. | *** ### `Cal Fetch Webhook By Event Type Id` Integration name: **CAL\_FETCH\_WEBHOOK\_BY\_EVENT\_TYPE\_ID** Retrieves details for a single, specific webhook using its `webhookId` and associated `eventTypeId`. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------------- | ------------------------------------- | | `webhookId` | string | ✅ | `"wh_abc123"` | Unique identifier for the webhook. | | `eventTypeId` | integer | ✅ | `"123"` | Unique identifier for the event type. | *** ### `Cal Force Refresh User Oauth Client` Integration name: **CAL\_FORCE\_REFRESH\_USER\_OAUTH\_CLIENT** Forces an immediate refresh of OAuth tokens for a Platform managed user. This is a Cal.com Platform API endpoint (deprecated as of December 2025 but still functional for existing customers). Use this endpoint when you've lost a managed user's access or refresh tokens and need to obtain new ones. Prerequisites: - A registered OAuth client application with Cal.com (provides clientId and x\_cal\_secret\_key) - The managed user must exist and be associated with your OAuth client - Valid OAuth client credentials (clientId and secret key) Token Validity: - Access tokens are valid for 60 minutes - Refresh tokens are valid for 1 year Important: Store the returned tokens securely in your database (e.g., as calAccessToken and calRefreshToken fields). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------- | :------: | ------------------------ | --------------------------------------------------------- | | `userId` | integer | ✅ | `"101"` | Unique numerical identifier of the managed user. | | `clientId` | string | ✅ | `"web_app_client_id"` | Unique string identifier of the OAuth client application. | | `x_cal_secret_key` | string | ✅ | `"cal_secret_abc123xyz"` | The OAuth client secret key, required for authentication. | *** ### `Cal Get All Timezones` Integration name: **CAL\_GET\_ALL\_TIMEZONES** Retrieves all supported time zone identifiers (e.g., `America/New_York`, `Europe/London`) and their associated metadata, excluding specific DST changes or precise UTC offset details. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Get Available Slots Info` Integration name: **CAL\_GET\_AVAILABLE\_SLOTS\_INFO** Retrieves available time slots for scheduling by considering existing bookings and availability, based on criteria like a specified time range and event type. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------- | :------: | ------------------------ | ------------------------------------------------------------------------------------------------------------ | | `endTime` | string | ✅ | `"2024-07-01T17:00:00Z"` | End date and time in UTC (ISO 8601 format) until which to fetch available slots. Must be after `startTime`. | | `orgSlug` | string | | `"acme-corp"` | The slug identifying the organization to which the event type or users belong. | | `duration` | integer | | `"15"` | The desired duration of the time slots in minutes. | | `timeZone` | string | | `"America/New_York"` | The IANA time zone identifier in which the available slots should be calculated and returned. | | `startTime` | string | ✅ | `"2024-07-01T09:00:00Z"` | Start date and time in UTC (ISO 8601 format) from which to fetch available slots. | | `slotFormat` | string | | `"range"` | Determines the format of the returned slot times. | | `eventTypeId` | integer | ✅ | `"123"` | Unique numeric identifier for the event type. | | `usernameList` | array | | `"johndoe"` | Required for dynamic or collective event types to specify the users whose availability should be considered. | | `eventTypeSlug` | string | | `"30-min-meeting"` | The URL-friendly string identifier (slug) of the event type. | | `rescheduleUid` | string | | `"bk_1abc2def3ghi"` | The unique identifier of an existing booking that is being rescheduled. | *** ### `Cal Get Booking Reference By Id` Integration name: **CAL\_GET\_BOOKING\_REFERENCE\_BY\_ID** Tool to find a specific booking reference by its ID. Use when you need to retrieve details about a single booking reference that links a booking to an external platform or calendar. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ---------- | ---------------------------------------- | | `id` | integer | ✅ | `23461188` | ID of the booking reference to retrieve. | *** ### `Cal Get Booking References` Integration name: **CAL\_GET\_BOOKING\_REFERENCES** Retrieves external references for a specific booking within an organization's team. Use when you need to get calendar or video platform integration details for a booking. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | -------------------------- | ---------------------------------------------------------------------- | | `type` | string | | `"google_calendar"` | Type of booking reference to filter by. | | `orgId` | integer | ✅ | `184337` | The ID of the organization that owns the booking. | | `teamId` | integer | ✅ | `184345` | The ID of the team within the organization that owns the booking. | | `bookingUid` | string | ✅ | `"rAXCQWMrV8pNjQTVxXeNVb"` | The unique identifier (UID) of the booking to retrieve references for. | *** ### `Cal Get Conference Oauth Authorization Url` Integration name: **CAL\_GET\_CONFERENCE\_OAUTH\_AUTHORIZATION\_URL** Generates an OAuth 2.0 authorization URL for a supported conferencing `app` to initiate or refresh its integration with Cal.com. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------ | :------: | --------------- | ------------------------------------------------------------------------------------------------------- | | `app` | string | ✅ | `"google_meet"` | The identifier of the conferencing application (e.g., `zoom`, `google_meet`). | | `returnTo` | string | ✅ | — | The URL to which the user will be redirected after successful OAuth authorization. | | `onErrorReturnTo` | string | ✅ | — | The URL to which the user will be redirected if an error occurs during the OAuth authorization process. | *** ### `Cal Get Default Schedule Details` Integration name: **CAL\_GET\_DEFAULT\_SCHEDULE\_DETAILS** Retrieves the Cal system's global default schedule configuration, not custom or user-specific ones. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Get Destination Calendars` Integration name: **CAL\_GET\_DESTINATION\_CALENDARS** Tool to retrieve all destination calendars configured for the authenticated user. Use when you need to find where new bookings will be created. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Get Event Type By Team Id` Integration name: **CAL\_GET\_EVENT\_TYPE\_BY\_TEAM\_ID** Retrieves a specific event type by its ID, requiring that the event type is associated with the given team ID. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------ | | `teamId` | integer | ✅ | `"123"` | The unique identifier for the team. | | `eventTypeId` | integer | ✅ | `"789"` | The unique identifier for the event type. Must be an event type associated with the provided `teamId`. | *** ### `Cal Get Event Type Private Links` Integration name: **CAL\_GET\_EVENT\_TYPE\_PRIVATE\_LINKS** Retrieves all private booking links for a specific event type. Private links allow sharing event booking URLs with restricted access, either time-limited or usage-limited. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | --------- | ------------------------------------------------------------------------------------ | | `eventTypeId` | integer | ✅ | `4518236` | The unique identifier of the event type for which private links are to be retrieved. | *** ### `Cal Get Google Calendar Oauth Authentication Url` Integration name: **CAL\_GET\_GOOGLE\_CALENDAR\_OAUTH\_AUTHENTICATION\_URL** Generates the initial Google Calendar OAuth 2.0 authorization URL for user redirection to begin the authentication and authorization process. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Get Oauth Clients User` Integration name: **CAL\_GET\_OAUTH\_CLIENTS\_USER** Retrieves all managed users associated with a Platform OAuth client. This endpoint is part of Cal.com's Platform API for managing users created through OAuth client credentials. Requires a valid Platform OAuth client ID and secret key, which are obtained when creating an OAuth client at . Use this to: - List all users managed under your OAuth client - Audit user access and permissions - Retrieve user profile details (email, timezone, locale, avatar, etc.) Authentication: Requires both Bearer token (from auth metadata) and `x-cal-secret-key` header. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------- | :------: | ---------------------------------------- | --------------------------------------------------------------------------------- | | `limit` | integer | | — | The maximum number of user records to return. | | `clientId` | string | ✅ | `"a1b2c3d4-e5f6-7890-1234-567890abcdef"` | The unique identifier of the OAuth client for which to retrieve associated users. | | `x_cal_secret_key` | string | | `"cal_secret_abc123xyz"` | The OAuth client secret key for authentication. | *** ### `Cal Get Organization Attribute Assigned Options` Integration name: **CAL\_GET\_ORGANIZATION\_ATTRIBUTE\_ASSIGNED\_OPTIONS** Retrieves all assigned attribute options for a specific attribute within an organization. This action returns the list of attribute options that have been assigned to users, along with which users have been assigned each option. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | `skip` | integer | | `0` | Number of responses to skip from the beginning (for pagination). | | `take` | integer | | `10` | Maximum number of responses to return (for pagination). | | `orgId` | integer | ✅ | `184337` | The unique identifier of the organization. | | `teamIds` | string | | `"100,200"` | Filter by team IDs. | | `attributeId` | string | ✅ | `"0641b76e-59b5-4c6e-bfaf-a838d2cf6a59"` | The unique UUID identifier of the attribute whose assigned options you want to retrieve. | | `assignedOptionIds` | string | | `"aaaaaaaa-bbbb-cccc-dddd-eeeeee1eee,aaaaaaaa-bbbb-cccc-dddd-eeeeee2eee"` | Filter by assigned attribute option IDs. | *** ### `Cal Get Organization Attribute Assigned Options By Slug` Integration name: **CAL\_GET\_ORGANIZATION\_ATTRIBUTE\_ASSIGNED\_OPTIONS\_BY\_SLUG** Tool to retrieve all assigned attribute options for a specific attribute by its slug within an organization. Use when you need to see which attribute options have been assigned to users, filtered by the attribute's slug identifier. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ----------------------------------------------------------------------------- | -------------------------------------------------- | | `skip` | integer | | `0` | Number of responses to skip for pagination. | | `take` | integer | | `10` | Number of responses to take for pagination. | | `orgId` | integer | ✅ | `184337` | The unique identifier of the organization. | | `teamIds` | array | | `[100,200]` | Filter by team IDs. | | `attributeSlug` | string | ✅ | `"department"` | The URL-friendly slug identifier of the attribute. | | `assignedOptionIds` | array | | `["aaaaaaaa-bbbb-cccc-dddd-eeeeee1eee","aaaaaaaa-bbbb-cccc-dddd-eeeeee2eee"]` | Filter by assigned attribute option IDs. | *** ### `Cal Get Organization Id` Integration name: **CAL\_GET\_ORGANIZATION\_ID** Retrieves the organization ID associated with the currently authenticated user from the Cal.com `/v2/me` endpoint. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Get Organization Schedules` Integration name: **CAL\_GET\_ORGANIZATION\_SCHEDULES** Retrieves availability schedules for an organization. Returns schedules that define when users are available for bookings, including working hours, time zones, and date-specific overrides. These are not individual events or appointments, but rather the availability templates that determine when bookings can be made. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | -------------------------------------------------------------------------- | | `skip` | integer | | `0` | The number of schedules to skip before returning results. | | `take` | integer | | `10` | The maximum number of schedules to return per page. | | `orgId` | integer | ✅ | `123` | The unique identifier of the organization for which to retrieve schedules. | *** ### `Cal Get Organization Teams Event Types` Integration name: **CAL\_GET\_ORGANIZATION\_TEAMS\_EVENT\_TYPES** Retrieves event types, including names, durations, and custom settings for team scheduling, for all teams within an existing organization specified by `orgId`. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------- | :------: | ------- | --------------------------------------------------------------------------------- | | `skip` | integer | | `0` | The number of event types to skip before starting to return results. | | `take` | integer | | `10` | The maximum number of event types to return. | | `orgId` | integer | ✅ | — | The unique identifier of the organization for which to retrieve team event types. | | `sortCreatedAt` | string | | `"asc"` | Order results by creation date. | *** ### `Cal Get Organization Team Workflows` Integration name: **CAL\_GET\_ORGANIZATION\_TEAM\_WORKFLOWS** Retrieves workflows configured for a specific team within an organization. Returns workflow configurations including triggers, steps, and activation settings. Use when you need to list or inspect workflow automations for a team. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | -------- | ------------------------------------------------------------------ | | `skip` | integer | | `0` | Number of workflows to skip before returning results. | | `take` | integer | | `25` | Maximum number of workflows to return per page. | | `orgId` | integer | ✅ | `184337` | The unique numeric identifier of the organization. | | `teamId` | integer | ✅ | `184336` | The unique numeric identifier of the team within the organization. | *** ### `Cal Get Organization User Schedules` Integration name: **CAL\_GET\_ORGANIZATION\_USER\_SCHEDULES** Retrieves all availability schedules configured for a specific user within an organization. Returns detailed schedule information including time slots, timezones, and overrides. Does not include booked events or appointments. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | --------- | ----------------------------------------------------------------------- | | `orgId` | integer | ✅ | `"12345"` | The unique identifier for the organization. | | `userId` | integer | ✅ | `"9876"` | The unique identifier for the user whose schedules are to be retrieved. | *** ### `Cal Get Private Links` Integration name: **CAL\_GET\_PRIVATE\_LINKS** Get all private links for a team event type. Use this to retrieve both time-based (with expiration) and usage-based (with usage limits) private links for scheduling. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------- | :------: | --------- | ----------------------------------------- | | `org_id` | integer | ✅ | `184337` | The unique identifier of the organization | | `team_id` | integer | ✅ | `184336` | The unique identifier of the team | | `event_type_id` | integer | ✅ | `4591148` | The unique identifier of the event type | *** ### `Cal Get Schedule For User In Team` Integration name: **CAL\_GET\_SCHEDULE\_FOR\_USER\_IN\_TEAM** Retrieves all availability schedules for a specific user within a team and organization. Returns schedule configurations including working hours, time zones, weekly availability patterns, default schedule designation, and date-specific overrides. Use this to understand when a team member is available for bookings. Requires valid userId (from team memberships), orgId (from organization list), and teamId (from teams list). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | -------------------------------------------------------------------- | | `orgId` | integer | ✅ | `67890` | Unique identifier for the organization. | | `teamId` | integer | ✅ | `11223` | Unique identifier for the team within the organization. | | `userId` | integer | ✅ | `12345` | Unique identifier for the user whose schedules you want to retrieve. | *** ### `Cal Get Selected Calendar By Id` Integration name: **CAL\_GET\_SELECTED\_CALENDAR\_BY\_ID** Tool to retrieve a selected calendar by its compound ID (`userId_integration_externalId`). Use when you need to fetch details of a specific calendar that has been selected for synchronization. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ----------------------------- | --------------------------------------------------------- | | `user_id` | integer | ✅ | `2090888` | User ID of the selected calendar to retrieve | | `external_id` | string | ✅ | `"partnerships@composio.dev"` | External ID of the calendar from the integration provider | | `integration` | string | ✅ | `"google_calendar"` | Integration provider of the selected calendar | *** ### `Cal Get Stripe Connect Info` Integration name: **CAL\_GET\_STRIPE\_CONNECT\_INFO** Retrieves Stripe Connect account details (ID, charges/payouts status, verification, settings) for the user's linked Cal.com account; response may be empty or indicate no integration if no account is linked. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Get Stripe Connect Url` Integration name: **CAL\_GET\_STRIPE\_CONNECT\_URL** Tool to get Stripe Connect authorization URL for a team within an organization. Use when you need to obtain a URL that allows team members to connect their Stripe account for payment processing on Cal.com. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ------------------------------- | ------------------------------------------------ | | `orgId` | integer | ✅ | `184337` | Organization identifier. | | `teamId` | integer | ✅ | `184336` | Team identifier. | | `returnTo` | string | ✅ | `"https://example.com/success"` | Redirect destination upon successful connection. | | `onErrorReturnTo` | string | ✅ | `"https://example.com/error"` | Redirect destination if connection fails. | *** ### `Cal Get Team Bookings` Integration name: **CAL\_GET\_TEAM\_BOOKINGS** Retrieves all bookings for a specified team, optionally filtered by status, attendee details, date ranges, or event type IDs, with support for pagination and sorting. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------- | :------: | ---------------------------- | ------------------------------------------------------------------------------ | | `skip` | integer | | `0` | Number of bookings to skip from the beginning of results. | | `take` | integer | | `10` | Maximum number of bookings to return. | | `status` | array | | `["upcoming","past"]` | Filter bookings by status. | | `teamId` | integer | ✅ | `184346` | The unique numeric identifier of the team whose bookings you want to retrieve. | | `sortEnd` | string | | `"asc"` | Sort order for end time. | | `beforeEnd` | string | | `"2025-03-07T11:00:00.000Z"` | Filter bookings ending before this ISO 8601 date or date-time string. | | `sortStart` | string | | `"asc"` | Sort order for start time. | | `afterStart` | string | | `"2025-03-07T10:00:00.000Z"` | Filter bookings starting after this ISO 8601 date or date-time string. | | `bookingUid` | string | | `"2NtaeaVcKfpmSZ4CthFdfk"` | Filter bookings by the unique booking UID. | | `eventTypeId` | string | | `"100"` | Filter bookings by a single event type ID belonging to the team. | | `sortCreated` | string | | `"asc"` | Sort order for creation time. | | `attendeeName` | string | | `"John Doe"` | Filter bookings by the name of an attendee. | | `eventTypeIds` | string | | `"100,200"` | Filter bookings by one or more event type IDs belonging to the team. | | `attendeeEmail` | string | | `"john.doe@example.com"` | Filter bookings by the exact email address of an attendee. | *** ### `Cal Get Team Default Conferencing App` Integration name: **CAL\_GET\_TEAM\_DEFAULT\_CONFERENCING\_APP** Retrieves the default conferencing application configured for a specific team within an organization. Use this to check which video platform (e.g., Zoom, Google Meet) is set as the team's default for scheduling meetings. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | -------- | -------------------------------------------------------------------------------------- | | `orgId` | integer | ✅ | `184337` | The unique identifier of the organization to which the team belongs. | | `teamId` | integer | ✅ | `184336` | The unique identifier of the team for which the default conferencing app is retrieved. | *** ### `Cal Get Team Details By Org Id And Team Id` Integration name: **CAL\_GET\_TEAM\_DETAILS\_BY\_ORG\_ID\_AND\_TEAM\_ID** Retrieves comprehensive details for a specific team within an organization, including team metadata, configuration settings, branding options, and timezone/week preferences. Use this to get team information like name, slug, bio, timezone, branding colors, and visibility settings. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | -------- | ------------------------------------------------------------------------ | | `orgId` | integer | ✅ | `"1001"` | The unique identifier of the organization to which the team belongs. | | `teamId` | integer | ✅ | `"505"` | The unique identifier of the team for which details are to be retrieved. | *** ### `Cal Get Team Event Type Webhook` Integration name: **CAL\_GET\_TEAM\_EVENT\_TYPE\_WEBHOOK** Retrieves details for a specific webhook configured on a team event type. Use when you need to inspect webhook configuration, verify settings, or troubleshoot webhook deliveries for team-managed event types. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ---------------------------------------- | -------------------------------------------------------------------- | | `teamId` | integer | ✅ | `184336` | The unique identifier of the team that owns the event type. | | `webhookId` | string | ✅ | `"ceb49b63-e528-4e81-91f3-c6c266394664"` | The unique identifier (UUID format) of the webhook to retrieve. | | `eventTypeId` | integer | ✅ | `4591148` | The unique identifier of the event type associated with the webhook. | *** ### `Cal Get Team Event Type Webhooks` Integration name: **CAL\_GET\_TEAM\_EVENT\_TYPE\_WEBHOOKS** Retrieves all webhooks configured for a specific team event type. Use this to audit webhook configurations or troubleshoot webhook delivery issues. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | --------- | ------------------------------------------------------------------------------- | | `skip` | integer | | `0` | Number of webhook records to skip for pagination. | | `take` | integer | | `25` | Maximum number of webhook records to return. | | `teamId` | integer | ✅ | `184336` | The unique numerical identifier of the team. | | `eventTypeId` | integer | ✅ | `4591148` | The unique identifier of the event type for which webhooks are to be retrieved. | *** ### `Cal Get Team Information By Team Id` Integration name: **CAL\_GET\_TEAM\_INFORMATION\_BY\_TEAM\_ID** Retrieves detailed information about a specific Cal.com team by its ID. Returns team configuration including name, slug, branding (logo, colors, theme), timezone settings, and privacy options. Requires the authenticated user to be a member of the team. Use `get_teams_list` to find available team IDs. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ------------------------------------------ | | `teamId` | integer | ✅ | `12345` | The unique numeric identifier of the team. | *** ### `Cal Get Team Routing Forms` Integration name: **CAL\_GET\_TEAM\_ROUTING\_FORMS** Retrieves routing forms for a specific team within an organization. Routing forms are used to collect information from potential bookers and route them to appropriate event types or team members based on their responses. Use this to fetch routing form configurations, fields, and routing logic for a team. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------------- | ------- | :------: | ------------------------ | ------------------------------------------------------------------ | | `skip` | integer | | `0` | Number of routing forms to skip for pagination (offset). | | `take` | integer | | `10` | Maximum number of routing forms to return per page. | | `orgId` | integer | ✅ | `184337` | The unique identifier of the organization containing the team. | | `teamId` | integer | ✅ | `184346` | The unique identifier of the team whose routing forms to retrieve. | | `sortCreatedAt` | string | | — | Enum for sort order values. | | `sortUpdatedAt` | string | | — | Enum for sort order values. | | `afterCreatedAt` | string | | `"2024-01-01T00:00:00Z"` | Filter to include only routing forms created after this date. | | `afterUpdatedAt` | string | | `"2024-01-01T00:00:00Z"` | Filter to include only routing forms updated after this date. | | `beforeCreatedAt` | string | | `"2024-12-31T23:59:59Z"` | Filter to include only routing forms created before this date. | | `beforeUpdatedAt` | string | | `"2024-12-31T23:59:59Z"` | Filter to include only routing forms updated before this date. | | `routedToBookingUid` | string | | `"abc123xyz"` | Filter routing forms by responses routed to a specific booking. | *** ### `Cal Get Team Schedules` Integration name: **CAL\_GET\_TEAM\_SCHEDULES** Retrieves availability schedules for all members of a specific team within an organization. Returns schedules that define when team members are available for bookings, including working hours, time zones, and date-specific overrides. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | -------- | ---------------------------------------------------------- | | `skip` | integer | | `0` | Number of schedules to skip before returning results. | | `take` | integer | | `25` | Maximum number of schedules to return. | | `orgId` | integer | ✅ | `184337` | The unique identifier of the organization. | | `teamId` | integer | ✅ | `184346` | The unique identifier of the team within the organization. | | `eventTypeId` | integer | | `1` | Filter schedules by a specific event type ID. | *** ### `Cal Get Teams List` Integration name: **CAL\_GET\_TEAMS\_LIST** Retrieves all teams the user belongs to, including their names and members. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Get Verified Phone Numbers` Integration name: **CAL\_GET\_VERIFIED\_PHONE\_NUMBERS** Retrieves a paginated list of verified phone numbers for a specific organization team. Use when you need to get phone numbers that have been verified and associated with a team. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | -------- | ------------------------------------------------------------------ | | `skip` | integer | | `0` | Number of items to skip for pagination. | | `take` | integer | | `25` | Maximum number of items to return. | | `orgId` | integer | ✅ | `184337` | The unique numeric identifier of the organization. | | `teamId` | integer | ✅ | `184336` | The unique numeric identifier of the team within the organization. | *** ### `Cal Get Webhook By Id` Integration name: **CAL\_GET\_WEBHOOK\_BY\_ID** Retrieves details for an existing and accessible webhook by its ID; this is a read-only operation. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ------- | ------------------------------------------------- | | `webhookId` | string | ✅ | — | The unique identifier of the webhook to retrieve. | *** ### `Cal Handle Conferencing Oauth Callback For App` Integration name: **CAL\_HANDLE\_CONFERENCING\_OAUTH\_CALLBACK\_FOR\_APP** Processes an OAuth 2.0 callback for a conferencing `app`, exchanging the `code` and `state` for access credentials; ensure an OAuth flow was previously initiated. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | --------------------------- | ---------------------------------------------------------------------- | | `app` | string | ✅ | `"zoom"` | Unique identifier for the conferencing application. | | `code` | string | ✅ | `"authCodeFromProvider123"` | Authorization code from the conferencing application's OAuth provider. | | `state` | string | ✅ | `"xyz123stateValue"` | OAuth state parameter for CSRF protection. | *** ### `Cal List Attendees` Integration name: **CAL\_LIST\_ATTENDEES** Tool to retrieve all attendees from Cal.com. Use when you need to get a complete list of all attendees across all bookings. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal List Booking References` Integration name: **CAL\_LIST\_BOOKING\_REFERENCES** Fetches one page of booking references in Cal.com. The Cal.com v2 API does not expose `/booking-references` for Bearer-token auth, so this action paginates the v2 `/bookings` endpoint and extracts each booking's `references` array. ONE Cal.com API call is made per invocation; pagination is caller-driven via the `cursor` parameter and the `next_cursor` field in the response. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | `take` | integer | | `100` | Number of bookings to fetch from the Cal.com v2 `/bookings` endpoint in this single call (1-100). | | `cursor` | — | | `12345` | Cal.com keyset cursor returned as `next_cursor` from a previous response. Omit on the first call; pass the value verbatim (as either int or str). | *** ### `Cal List Event Types` Integration name: **CAL\_LIST\_EVENT\_TYPES** Retrieves Cal event types, filterable by `username` (required if `eventSlug` is provided), multiple `usernames`, or organization details (`orgSlug` or `orgId`). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | -------------------- | -------------------------------------------------------------------------------------------------------- | | `orgId` | integer | | `"101"` | The unique identifier of the user's organization. | | `orgSlug` | string | | `"acme-innovations"` | The slug of the user's organization. | | `username` | string | | `"johndoe"` | The username of the user whose event types are to be retrieved. | | `eventSlug` | string | | `"30min-meeting"` | The slug of a specific event type to retrieve. | | `usernames` | string | | `"alice,bob"` | A comma-separated string of usernames to retrieve dynamic event types for multiple users simultaneously. | *** ### `Cal List Organization Memberships` Integration name: **CAL\_LIST\_ORGANIZATION\_MEMBERSHIPS** Retrieves all memberships for a given organization, including user details, roles, status, and membership dates. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ------------------------------------------------------------------------ | | `skip` | integer | | `"0"` | The number of initial membership records to skip. | | `take` | integer | | `"10"` | The maximum number of membership records to return. | | `orgId` | integer | ✅ | — | The unique identifier of the organization for which to list memberships. | *** ### `Cal List Team Event Types By Org And Team Id` Integration name: **CAL\_LIST\_TEAM\_EVENT\_TYPES\_BY\_ORG\_AND\_TEAM\_ID** Retrieves all event types for a specific team within an organization, optionally filtering by a specific event slug. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | --------------------- | ----------------------------------------------------------------------------- | | `orgId` | integer | ✅ | `12345` | The unique numeric identifier of the organization. | | `teamId` | integer | ✅ | `9876` | The unique numeric identifier of the team whose event types are to be listed. | | `eventSlug` | string | | `"15-minute-meeting"` | Optional slug of a specific team event type. | *** ### `Cal Mark Booking Absent For Uid` Integration name: **CAL\_MARK\_BOOKING\_ABSENT\_FOR\_UID** Marks the host and/or specified attendees as absent for an existing booking, typically used after a scheduled event to record no-shows. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ---------------------- | ---------------------------------------- | | `host` | boolean | | — | If true, marks the host as absent. | | `attendees` | array | | — | List of attendees to mark as absent. | | `bookingUid` | string | ✅ | `"bk_123abc456xyz789"` | Unique identifier (UID) for the booking. | *** ### `Cal Modify Organization Membership By Id` Integration name: **CAL\_MODIFY\_ORGANIZATION\_MEMBERSHIP\_BY\_ID** Updates an organization membership's status (`accepted`), role, or impersonation settings, identified by `orgId` and `membershipId` in the path; requires at least one of these fields in the request to apply changes. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ---------- | ---------------------------------------------------------------------------------------- | | `role` | string | | `"MEMBER"` | New role for the member; if omitted, role is unchanged. | | `orgId` | integer | ✅ | — | Organization's unique identifier. | | `accepted` | boolean | | — | Set true to accept membership, false to decline/revoke; if omitted, status is unchanged. | | `membershipId` | integer | ✅ | — | Membership's unique identifier to modify. | | `disableImpersonation` | boolean | | — | Set true to disable impersonation, false to enable; if omitted, setting is unchanged. | *** ### `Cal Modify Org Attribute By Id` Integration name: **CAL\_MODIFY\_ORG\_ATTRIBUTE\_BY\_ID** Partially updates an organization attribute using `orgId` and `attributeId`, allowing modification of its name, slug, type, or enabled status; changing the `type` may affect existing data. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ----------------- | ---------------------------------------------------------------------------------------------------------- | | `name` | string | | `"Customer Tier"` | The new name for the attribute. | | `slug` | string | | `"customer-tier"` | The new URL-friendly slug for the attribute. | | `type` | string | | `"TEXT"` | The new type for the attribute; changing the type may affect existing data associated with this attribute. | | `orgId` | integer | ✅ | — | The unique identifier for the organization. | | `enabled` | boolean | | `"true"` | Specifies whether the attribute should be enabled or disabled. | | `attributeId` | string | ✅ | — | The unique identifier for the attribute to be modified. | *** ### `Cal Patch Organization Attribute Option` Integration name: **CAL\_PATCH\_ORGANIZATION\_ATTRIBUTE\_OPTION** Partially updates a specific option for an organization's attribute, modifying its `value` and/or `slug`; at least one of `value` or `slug` must be provided. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | -------------------- | ---------------------------------------------------------------------- | | `slug` | string | | `"engineering"` | The new URL-friendly programmatic identifier for the attribute option. | | `orgId` | integer | ✅ | `123` | The unique identifier of the organization. | | `value` | string | | `"Engineering"` | The new human-readable display value for the attribute option. | | `optionId` | string | ✅ | `"clo456def789ghi"` | The unique identifier of the attribute option to be updated. | | `attributeId` | string | ✅ | `"clq1abc123def456"` | The unique identifier of the attribute whose option is being updated. | *** ### `Cal Patch Organization User Details` Integration name: **CAL\_PATCH\_ORGANIZATION\_USER\_DETAILS** Partially updates details for a user that exists within the specified organization. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------------- | ------- | :------: | -------- | ------------------------------------------------------------------ | | `bio` | string | | — | A short biography or description of the user. | | `name` | string | | — | The display name of the user. | | `email` | string | | — | The email address of the user to update. | | `orgId` | integer | ✅ | `"1001"` | The unique identifier of the organization. | | `theme` | string | | — | The UI theme preference for the user. | | `locale` | string | | — | The locale/language preference for the user. | | `userId` | integer | ✅ | `"500"` | The unique identifier of the user whose details are to be updated. | | `timeZone` | string | | — | The timezone of the user. | | `avatarUrl` | string | | — | The URL of the user's avatar image. | | `weekStart` | string | | — | The day the week starts for the user. | | `brandColor` | string | | — | The primary brand color in hex format. | | `timeFormat` | integer | | — | The time format preference (12 for 12-hour, 24 for 24-hour). | | `hideBranding` | boolean | | — | Whether to hide Cal.com branding for this user. | | `darkBrandColor` | string | | — | The brand color for dark mode in hex format. | | `defaultScheduleId` | integer | | — | The ID of the default schedule for this user. | | `allowDynamicBooking` | boolean | | — | Whether to allow dynamic booking for this user. | *** ### `Cal Patch Team Details By Id` Integration name: **CAL\_PATCH\_TEAM\_DETAILS\_BY\_ID** Updates specified details for an existing team identified by `teamId`; unspecified fields remain unchanged. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------------------ | ------- | :------: | -------------------------------------------------- | ---------------------------------------------------------- | | `bio` | string | | `"This team focuses on new market acquisition."` | Short biography or description for the team. | | `name` | string | | `"Marketing Team"` | The new name for the team. | | `slug` | string | | `"marketing-team"` | Unique URL-friendly identifier for the team. | | `theme` | string | | `"dark"` | Color theme for team booking pages. | | `teamId` | integer | ✅ | — | The unique identifier of the team to be updated. | | `appLogo` | string | | `"https://example.com/logos/app_logo.png"` | URL for the logo in the Cal.com application for this team. | | `logoUrl` | string | | `"https://example.com/logos/team_logo.png"` | URL of the team's logo image. | | `metadata` | object | | `{"cost_center":"CC456","department_id":"DPT123"}` | Custom key-value metadata for the team. | | `timeZone` | string | | `"America/Los_Angeles"` | IANA time zone; affects default schedule. | | `bannerUrl` | string | | `"https://example.com/banners/team_banner.jpg"` | URL of the team's banner image for their booking page. | | `isPrivate` | boolean | | — | If true, team is private and not publicly discoverable. | | `weekStart` | string | | `"Sunday"` | Start day of the week for team calendar views. | | `brandColor` | string | | `"#1A2B3C"` | Primary brand color for the team. | | `timeFormat` | integer | | `"12"` | Preferred time format. | | `appIconLogo` | string | | `"https://example.com/logos/app_icon.ico"` | URL for the icon logo in the application. | | `calVideoLogo` | string | | `"https://example.com/logos/cal_video_logo.png"` | URL for the logo in Cal Video sessions for this team. | | `hideBranding` | boolean | | — | If true, hides Cal.com branding on team booking pages. | | `bookingLimits` | object | | `{"per_day":10,"per_week":50,"future_days":90}` | Booking limits, conforming to Cal.com's schema. | | `darkBrandColor` | string | | `"#FFFFFF"` | Brand color for dark theme. | | `hideBookATeamMember` | boolean | | — | If true, hides booking specific team members. | | `includeManagedEventsInLimits` | boolean | | — | If true, team-managed events count towards booking limits. | *** ### `Cal Patch Webhook Event Type` Integration name: **CAL\_PATCH\_WEBHOOK\_EVENT\_TYPE** Updates configuration (e.g., payload template, active status, URL, triggers, secret) for an existing webhook tied to a specific event type. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------ | | `active` | boolean | | `"true"` | Set `true` to activate or `false` to deactivate the webhook. | | `secret` | string | | `"your-secure-secret-string-for-signing"` | Secret key to sign webhook payloads, verifying their origin. | | `triggers` | string | | `"BOOKING_CREATED"` | Specific event that triggers the webhook. | | `webhookId` | string | ✅ | `"wh_clx05g1vx000008l3e1z89xts"` | Unique identifier of the webhook to be updated. | | `eventTypeId` | integer | ✅ | `"12345"` | Unique identifier of the event type for the webhook. | | `subscriberUrl` | string | | `"https://api.example.com/webhook-receiver"` | URL where webhook notifications are sent. | | `payloadTemplate` | string | | `"{\"event_type\": \"{{triggerEvent}}\", \"attendee_email\": \"{{attendeeEmail}}\", \"booking_id\": \"{{bookingId}}\"}"` | Template for the payload sent to `subscriberUrl`. | *** ### `Cal Post Calendar Credentials` Integration name: **CAL\_POST\_CALENDAR\_CREDENTIALS** Use to submit/update authentication credentials (passed in the request body) for an existing calendar, enabling Cal to connect with external calendar services for synchronization. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | --------------------- | -------------------------------------------------------------------------------------------------------------- | | `calendar` | string | ✅ | `"apple"` | The calendar type for which credentials will be posted. Currently only `apple` is supported for this endpoint. | | `password` | string | ✅ | `"your_app_password"` | The Apple account app-specific password for calendar access. | | `username` | string | ✅ | `"user@icloud.com"` | The Apple account username (typically an iCloud email address). | *** ### `Cal Post Conferencing App Connect` Integration name: **CAL\_POST\_CONFERENCING\_APP\_CONNECT** Connects or reconnects Cal.com with a specified conferencing application to enable future virtual meeting scheduling, but does not itself create or schedule meetings. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `app` | string | ✅ | `"google-meet"` | Identifier of the conferencing application for establishing its connection with Cal.com. Note: Google Meet requires a Google Calendar connection first. | *** ### `Cal Post New Booking Request` Integration name: **CAL\_POST\_NEW\_BOOKING\_REQUEST** Creates a new booking for an event type at a specified start time. Use this action to schedule a meeting with a Cal.com user. Prerequisites: 1. Get a valid event type ID from `list_event_types` 2. Find an available time slot using `get_available_slots_info` 3. Provide attendee name and email in the `responses` object 4. Specify timezone and language preferences The booking will be created with status `ACCEPTED` if no confirmation is required, or `PENDING` if the event type requires host confirmation. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------------ | ------- | :------: | ---------------------------------------------------- | ----------------------------------------------------------------------------------- | | `start` | string | ✅ | `"2024-09-15T10:00:00Z"` | Start date and time for the booking in ISO 8601 format in UTC. | | `guests` | array | | `["guest1@example.com","guest2@example.com"]` | List of additional guest email addresses to invite to the event. | | `instant` | boolean | | `true` | Whether this is an instant booking that bypasses approval flows (team events only). | | `routing` | object | | `{"teamMemberIds":[123,456]}` | Routing form response data with team member IDs for assignment. | | `language` | string | ✅ | `"en"` | ISO 639-1 language code for communications with the attendee. | | `location` | object | | `{"type":"integrations:daily"}` | Location object matching one of the event type's configured locations. | | `metadata` | object | | `{}` | Custom key-value metadata for tracking or analytics. | | `teamSlug` | string | | `"engineering"` | Team slug for event type identification when using eventTypeSlug. | | `timeZone` | string | ✅ | `"America/New_York"` | IANA timezone identifier for the attendee. | | `username` | string | | `"johndoe"` | Username of the host for event type identification when using eventTypeSlug. | | `responses` | object | ✅ | `{"name":"John Doe","email":"john.doe@example.com"}` | Attendee details object. Required keys: `name` and `email`. | | `eventTypeId` | integer | | `3116942` | Unique numeric identifier of the event type to be booked. | | `eventTypeSlug` | string | | `"30min"` | Slug of the event type. | | `lengthInMinutes` | integer | | `15` | Duration of the event in minutes. | | `organizationSlug` | string | | `"acme-corp"` | Optional organization slug when using eventTypeSlug with username or teamSlug. | | `emailVerificationCode` | string | | `"ABC123"` | Email verification code if the event type requires email verification. | | `bookingFieldsResponses` | object | | `{"projectCode":"ABC-123"}` | Key/value responses to custom booking fields defined for the event type. | *** ### `Cal Post Org Attribute Option By User` Integration name: **CAL\_POST\_ORG\_ATTRIBUTE\_OPTION\_BY\_USER** Assigns an existing attribute option (using `attributeOptionId`) or creates a new one (using `value`) for a user, linking it to a specified `attributeId` which must already exist within the organization. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | -------------------- | -------------------------------------------------------------------------------------------------- | | `orgId` | integer | ✅ | `12345` | The unique identifier for the organization. | | `value` | string | | `"Morning Shift"` | Value for a new attribute option to be created under `attributeId` and then assigned to the user. | | `userId` | integer | ✅ | `2090888` | The unique identifier for the user within the organization to assign the attribute option to. | | `attributeId` | string | ✅ | `"clq1abc123def456"` | The unique identifier of the attribute to which this option belongs or will be added and assigned. | | `attributeOptionId` | string | | `"opt_abc123"` | Identifier of an existing attribute option to be assigned to the user for `attributeId`. | *** ### `Cal Post Selected Calendars` Integration name: **CAL\_POST\_SELECTED\_CALENDARS** Links a new external calendar or updates an existing link to one, enabling synchronization with the Cal application by specifying the `integration` provider, the calendar's `externalId`, and the `credentialId`. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ------------------- | ------------------------------------------------------------------------------------------------------ | | `externalId` | string | ✅ | `"primary"` | Unique identifier of the specific calendar within the external service. | | `integration` | string | ✅ | `"google_calendar"` | Specifies the external calendar system to connect with. | | `credentialId` | integer | ✅ | `"101"` | Unique identifier for the stored credential authorizing Cal's access to the external calendar service. | *** ### `Cal Post User To Organization` Integration name: **CAL\_POST\_USER\_TO\_ORGANIZATION** Adds a new user to an existing organization (identified by `orgId` in path), requiring user's `email` and allowing extensive optional profile customization. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ------------------------------------------- | ------------------------------------------------------------------- | | `email` | string | ✅ | `"new.user@example.com"` | Email address of the user. | | `orgId` | integer | ✅ | `"123"` | Unique identifier of the organization. | | `theme` | string | | `"light"` | Preferred visual theme for the application. | | `locale` | string | | `"en"` | Preferred language and regional settings. | | `weekday` | string | | `"monday"` | Preferred start day of the week for calendar views. | | `appTheme` | string | | `"calcom-light"` | Preferred application-specific theme with granular styling options. | | `timeZone` | string | | `"America/New_York"` | Preferred time zone. | | `username` | string | | `"new_user_123"` | Desired username. | | `avatarUrl` | string | | `"https://example.com/avatars/user123.png"` | URL for the user's avatar image. | | `autoAccept` | boolean | | — | If true, user automatically accepts event invitations. | | `brandColor` | string | | `"#3F51B5"` | Preferred brand color for the interface. | | `timeFormat` | integer | | `"12"` | Preferred time display format. | | `hideBranding` | boolean | | — | Set to true to hide Cal.com branding. | | `darkBrandColor` | string | | `"#1A237E"` | Preferred brand color for dark mode interface. | | `organizationRole` | string | | — | Role of the user within the organization. | | `defaultScheduleId` | integer | | `"789"` | ID of the default schedule for the new user. | *** ### `Cal Post Webhook Event` Integration name: **CAL\_POST\_WEBHOOK\_EVENT** Creates a new Cal.com webhook subscription to send real-time notifications for specified calendar events (like bookings, meetings, forms) to a publicly accessible subscriber URL. Supports custom payload templates and webhook signature verification via HMAC-SHA256. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | `active` | boolean | ✅ | `true` | Indicates if the webhook is active. | | `secret` | string | | `"mySuperSecretKey"` | Secret key for signing the webhook payload. | | `triggers` | array | ✅ | `["BOOKING_CREATED"]` | The list of event types that will trigger this webhook notification. | | `subscriberUrl` | string | ✅ | `"https://api.example.com/webhook-receiver"` | The callback URL where webhook notifications will be sent. | | `payloadTemplate` | string | | `"{\"event_type\": \"{{type}}\", \"booking_title\": \"{{title}}\", \"organizer\": \"{{organizer.name}}\"}"` | JSON string template for the webhook payload, using placeholders like `{{type}}` for dynamic data. | *** ### `Cal Reassign Booking To Another User` Integration name: **CAL\_REASSIGN\_BOOKING\_TO\_ANOTHER\_USER** Reassigns an existing booking to a specified user. Requires `cal-api-version 2024-08-13`. The booking owner must be authorized to perform the reassignment. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------------------------------------------------- | ----------------------------------------------------------------------- | | `reason` | string | | `"Original host is unavailable due to sickness."` | An optional text explaining the reason for reassigning the booking. | | `userId` | integer | ✅ | `101` | The numerical ID of the user to whom the booking will be reassigned. | | `bookingUid` | string | ✅ | `"bk_123xyz789abc"` | The unique identifier (UID) of the booking that needs to be reassigned. | *** ### `Cal Reassign Booking With Uid` Integration name: **CAL\_REASSIGN\_BOOKING\_WITH\_UID** Reassigns the specified booking to a new team member, who is determined by the system rather than being specified in the request. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ---------------- | -------------------------------------------------------- | | `bookingUid` | string | ✅ | `"bk_123xyz789"` | Unique identifier (UID) of the booking to be reassigned. | *** ### `Cal Refresh Oauth Token For Client Id` Integration name: **CAL\_REFRESH\_OAUTH\_TOKEN\_FOR\_CLIENT\_ID** Refreshes an OAuth access token for a specified `clientId` and managed user using their `refreshToken`. This is a Cal.com Platform feature for developers building applications that manage users. Prerequisites: - A registered OAuth client application with Cal.com (provides clientId) - The OAuth client secret key (`x_cal_secret_key`) - A valid refresh token obtained when creating a managed user The endpoint implements refresh token rotation - both access and refresh tokens are returned. Access tokens expire after 60 minutes; refresh tokens expire after 1 year. Note: This endpoint is marked as deprecated in Cal.com docs and may be replaced in future versions. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------ | :------: | -------------------------------------------- | ------------------------------------------------------------------------------------- | | `clientId` | string | ✅ | `"client_app_123xyz"` | The unique identifier of the OAuth client application whose token is being refreshed. | | `refreshToken` | string | ✅ | `"rt_a1b2c3d4e5f67890_example_token_string"` | The refresh token for the managed user, used to obtain a new access token. | | `x_cal_secret_key` | string | ✅ | `"cal_secret_abc123xyz"` | The OAuth client secret key, required for authentication. | *** ### `Cal Request Email Verification Code` Integration name: **CAL\_REQUEST\_EMAIL\_VERIFICATION\_CODE** Request an email verification code for a team's verified resources. Use this action when you need to verify an email address for a team. The API will send a verification code to the specified email address. After receiving the code, you'll need to use it with a separate verification endpoint to complete the email verification process. This is typically used to verify email addresses that will be used as verified resources within a team. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | -------------------- | -------------------------------------------------------------------------- | | `email` | string | ✅ | `"acme@example.com"` | Email address to verify. | | `teamId` | integer | ✅ | `184346` | The unique identifier of the team for which to request email verification. | *** ### `Cal Reschedule Booking By Uid` Integration name: **CAL\_RESCHEDULE\_BOOKING\_BY\_UID** Reschedules an existing booking (identified by `bookingUid`) to a new time. Requires the booking UID and the new start time in ISO 8601 format. Optionally, you can provide a rescheduling reason and the email of the person rescheduling. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------------- | ------ | :------: | ----------------------------- | ------------------------------------------------------------------------ | | `start` | string | ✅ | `"2024-08-13T10:00:00Z"` | The new start time for the booking in ISO 8601 format. | | `bookingUid` | string | ✅ | `"qSzjkEyRkNP6aYyuYBvTPw"` | The unique identifier (UID) of the booking that needs to be rescheduled. | | `rescheduledBy` | string | | `"user@example.com"` | Email of the person who is rescheduling the booking. | | `reschedulingReason` | string | | `"User requested reschedule"` | The reason for rescheduling the booking. | | `emailVerificationCode` | string | | `"123456"` | Required when event type has email verification enabled. | *** ### `Cal Reserve Slot For Event` Integration name: **CAL\_RESERVE\_SLOT\_FOR\_EVENT** Temporarily reserves an available time slot for an existing and bookable event type, useful for high-demand slots to prevent double-bookings while the user completes the booking. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------- | :------: | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | | `bookingUid` | string | | `"booking-uid-123"` | Optional unique identifier, typically used for events with seats to associate the reservation with a specific booking or seat. | | `eventTypeId` | integer | ✅ | `"123"` | The unique identifier for the event type for which the time slot is being reserved. | | `slotUtcEndDate` | string | ✅ | `"2024-07-15T11:00:00Z"` | The end date and time of the slot to be reserved, in UTC. | | `slotUtcStartDate` | string | ✅ | `"2024-07-15T10:00:00Z"` | The start date and time of the slot to be reserved, in UTC. | *** ### `Cal Retrieve Attribute Options For Org` Integration name: **CAL\_RETRIEVE\_ATTRIBUTE\_OPTIONS\_FOR\_ORG** Retrieves all available options for a specific attribute within an organization. This action returns the list of selectable options for SINGLE\_SELECT or MULTI\_SELECT type attributes. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------- | | `orgId` | integer | ✅ | `184337` | The unique numerical identifier of the organization. | | `attributeId` | string | ✅ | `"1eed080a-36d4-4e51-bdee-b7debe2786f4"` | The unique UUID identifier of the attribute whose options you want to retrieve. | *** ### `Cal Retrieve Booking Details By Uid` Integration name: **CAL\_RETRIEVE\_BOOKING\_DETAILS\_BY\_UID** Fetches comprehensive details for an existing booking, identified by its `bookingUid`. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ------------------- | --------------------------------------- | | `bookingUid` | string | ✅ | `"bk_123xyz789abc"` | Unique identifier (UID) of the booking. | *** ### `Cal Retrieve Calendar Busy Times` Integration name: **CAL\_RETRIEVE\_CALENDAR\_BUSY\_TIMES** To find busy calendar slots for scheduling/conflict detection, call this with a valid `credentialId`, an `externalId` accessible by it, and a recognized IANA `loggedInUsersTz`; returns only busy intervals, not event details or free slots. Use `credentialId`/`externalId` for single calendar queries. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ------------------------ | --------------------------------------------------------------------------------------------- | | `dateTo` | string | | `"2024-03-17T17:00:00Z"` | The end date and time for querying busy times in ISO 8601 format. | | `dateFrom` | string | | `"2024-03-10T09:00:00Z"` | The start date and time for querying busy times. | | `externalId` | string | ✅ | `"primary"` | The external identifier of the specific calendar to query. | | `credentialId` | integer | ✅ | `12345` | The numeric identifier for the credential associated with the calendar account to be queried. | | `loggedInUsersTz` | string | ✅ | `"America/New_York"` | The IANA timezone string of the logged-in user. | *** ### `Cal Retrieve Calendar List` Integration name: **CAL\_RETRIEVE\_CALENDAR\_LIST** Retrieves a list of all calendar summaries (no event details) associated with the authenticated user's account. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Retrieve Current Team For Organization` Integration name: **CAL\_RETRIEVE\_CURRENT\_TEAM\_FOR\_ORGANIZATION** Retrieves details of the team(s) for the currently authenticated user within the specified organization `orgId`. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ----------------------------------------------------------------------------------------------------------- | | `skip` | integer | | `0` | The number of team entries to skip from the beginning of the list. | | `take` | integer | | `10` | The maximum number of team entries to return. | | `orgId` | integer | ✅ | — | The unique identifier of the organization for which the current user's team information is being requested. | *** ### `Cal Retrieve Default Conferencing Settings` Integration name: **CAL\_RETRIEVE\_DEFAULT\_CONFERENCING\_SETTINGS** Retrieves an account's or organization's read-only default conferencing settings in Cal.com (e.g., video platform, meeting duration) to inform event creation or ensure consistency. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Retrieve Event Type By Id` Integration name: **CAL\_RETRIEVE\_EVENT\_TYPE\_BY\_ID** Retrieves comprehensive details for a specific, existing Cal.com event type using its unique ID; this is a read-only action and does not return associated events or bookings. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | --------- | ----------------------------------------- | | `eventTypeId` | string | ✅ | `"12345"` | The unique identifier for the event type. | *** ### `Cal Retrieve Membership From Organization` Integration name: **CAL\_RETRIEVE\_MEMBERSHIP\_FROM\_ORGANIZATION** Retrieves detailed information about a specific membership within a particular organization. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ----------- | ---------------------------------------------------------------- | | `orgId` | integer | ✅ | `"184337"` | The unique identifier of the organization. | | `membershipId` | integer | ✅ | `"1329743"` | The unique identifier of the membership within the organization. | *** ### `Cal Retrieve My Information` Integration name: **CAL\_RETRIEVE\_MY\_INFORMATION** Retrieves the authenticated user's core profile information (e.g., name, email, timezone); does not retrieve related data like calendar events or schedules. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Retrieve Oauth Client User By Id` Integration name: **CAL\_RETRIEVE\_OAUTH\_CLIENT\_USER\_BY\_ID** Retrieves detailed profile information for a specific managed user associated with an OAuth client. This endpoint is part of Cal.com's Platform API for OAuth client management. It requires: - A valid OAuth client ID (`clientId`) obtained from the Cal.com Platform dashboard - A valid managed user ID (`userId`) that was created via the create managed user endpoint - OAuth client secret key (`x_cal_secret_key`) for authentication Returns the user's profile including email, name, timezone, schedule settings, and custom metadata. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------- | :------: | ----------------------------- | ---------------------------------------------------------------- | | `userId` | integer | ✅ | `1001` | The unique numerical identifier of the managed user to retrieve. | | `clientId` | string | ✅ | `"clzocd3lh000008lgha4e4fp5"` | The unique identifier of the OAuth client. | | `x_cal_secret_key` | string | ✅ | `"cal_secret_abc123xyz"` | The OAuth client secret key for Platform API authentication. | *** ### `Cal Retrieve Oauth Client Webhook By Id` Integration name: **CAL\_RETRIEVE\_OAUTH\_CLIENT\_WEBHOOK\_BY\_ID** Retrieves detailed configuration for a specific webhook by ID from a Platform OAuth client. This Platform API endpoint requires OAuth client credentials (`clientId` and `x-cal-secret-key`) to access webhook settings including subscriber URL, active status, event triggers, payload template, and verification secret. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------ | :------: | ----------------------------- | -------------------------------------------------------------------------- | | `clientId` | string | ✅ | `"clxj8s9j3000108l37twm86xy"` | The unique identifier of the Platform OAuth client that owns the webhook. | | `webhookId` | string | ✅ | `"12345"` | The unique identifier of the webhook to retrieve. | | `x_cal_secret_key` | string | ✅ | `"cal_secret_your_key_here"` | The Platform OAuth client secret key required for authenticating requests. | *** ### `Cal Retrieve Organization Attributes` Integration name: **CAL\_RETRIEVE\_ORGANIZATION\_ATTRIBUTES** Retrieves detailed attributes for an organization, identified by its `orgId`, which must correspond to an existing organization. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ----------------------------------------------------------------------------------- | | `skip` | integer | | `"0"` | The number of attributes to skip before starting to return items. | | `take` | integer | | `"10"` | The maximum number of attributes to return. | | `orgId` | integer | ✅ | `"123"` | The unique identifier of the organization for which attributes are to be retrieved. | *** ### `Cal Retrieve Organization Attributes Options` Integration name: **CAL\_RETRIEVE\_ORGANIZATION\_ATTRIBUTES\_OPTIONS** Retrieves all attribute options assigned to a specific user within an organization. Attribute options are customizable organizational metadata (like department, role, location, or team) that organizations define and assign to users for flexible categorization and management. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ----------- | ---------------------------------------------------------- | | `orgId` | integer | ✅ | `"184337"` | The unique identifier of the organization. | | `userId` | integer | ✅ | `"1547273"` | The unique identifier of the user within the organization. | *** ### `Cal Retrieve Organization Webhook By Id` Integration name: **CAL\_RETRIEVE\_ORGANIZATION\_WEBHOOK\_BY\_ID** Retrieves detailed information, including configuration and status, for a specific webhook by its ID (`webhookId`) within a given organization (`orgId`). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------- | | `orgId` | integer | ✅ | `184337` | The unique numeric identifier of the organization to which the webhook belongs. | | `webhookId` | string | ✅ | `"a4db4d1d-5712-4239-ab5d-201becc7b4b7"` | The unique identifier (UUID) of the webhook to retrieve. | *** ### `Cal Retrieve Organization Webhooks By Org Id` Integration name: **CAL\_RETRIEVE\_ORGANIZATION\_WEBHOOKS\_BY\_ORG\_ID** Retrieves all webhooks configured for a specific organization, returning an array of webhook objects with their configuration details (ID, triggers, subscriber URL, active status, etc.). Supports pagination via `take` and `skip` parameters. This is a read-only operation that does not modify any webhooks. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ------------------------------------------------------------------------- | | `skip` | integer | | `0` | Number of webhooks to skip (for pagination). | | `take` | integer | | `10` | Maximum number of webhooks to return. | | `orgId` | integer | ✅ | — | The unique identifier of the organization for which to retrieve webhooks. | *** ### `Cal Retrieve Provider Details` Integration name: **CAL\_RETRIEVE\_PROVIDER\_DETAILS** Verifies and retrieves details for an OAuth client (provider) in Cal.com's Platform API. This endpoint is part of Cal.com's Platform API for managing OAuth clients. It verifies the OAuth client credentials (`clientId` and `x-cal-secret-key`) and returns provider details including the client ID, associated organization ID, and provider name. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------ | :------: | ---------------------------------------- | ----------------------------------------------------------- | | `clientId` | string | ✅ | `"a1b2c3d4-e5f6-7890-1234-567890abcdef"` | Unique identifier of the OAuth client (provider) to verify. | | `x_cal_secret_key` | string | ✅ | `"cal_secret_abc123xyz"` | The OAuth client secret key, required for authentication. | *** ### `Cal Retrieve Schedules List` Integration name: **CAL\_RETRIEVE\_SCHEDULES\_LIST** Retrieve all availability schedules for the authenticated Cal.com user. This action returns a list of schedules that define when a user is available for bookings. Each schedule includes availability time blocks, timezone, and whether it's the default schedule. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Retrieve Team Details In Organization` Integration name: **CAL\_RETRIEVE\_TEAM\_DETAILS\_IN\_ORGANIZATION** Retrieves a paginated list of teams and their details for a specific organization ID; individual team member details or schedules are not included. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ----------------------------------------------------------------------------------- | | `skip` | integer | | `0` | Number of teams to skip for pagination (offset). | | `take` | integer | | `10` | Maximum number of teams to return per page. | | `orgId` | integer | ✅ | `101` | The unique numeric identifier of the organization whose teams you want to retrieve. | *** ### `Cal Retrieve Team Event Types` Integration name: **CAL\_RETRIEVE\_TEAM\_EVENT\_TYPES** Retrieves event types for a team within the Cal scheduling system; this action does not provide details on scheduled instances or member availability. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | --------------------- | -------------------------------------------------------------------------------------- | | `teamId` | integer | ✅ | `101` | The unique numerical identifier of the team for which event types are to be retrieved. | | `eventSlug` | string | | `"30-minute-meeting"` | The URL-friendly slug of a specific team event type. | | `hostsLimit` | integer | | `5` | Maximum number of hosts to include in the response. | *** ### `Cal Retrieve Team Membership By Id` Integration name: **CAL\_RETRIEVE\_TEAM\_MEMBERSHIP\_BY\_ID** Retrieves detailed information for a specific team membership by its ID within an organization's team. Returns membership details including the user's role (`MEMBER`, `OWNER`, or `ADMIN`), acceptance status, impersonation settings, and user profile information. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ------- | ----------------------------------------------------------------- | | `orgId` | integer | ✅ | `12345` | The unique identifier of the organization that contains the team. | | `teamId` | integer | ✅ | `67890` | The unique identifier of the team within the organization. | | `membershipId` | integer | ✅ | `11223` | The unique identifier of the membership record to retrieve. | *** ### `Cal Retrieve Team Membership Details` Integration name: **CAL\_RETRIEVE\_TEAM\_MEMBERSHIP\_DETAILS** Retrieves detailed attributes for a specific team membership by its ID and the team ID, such as member information, role, and status; does not list all team members. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ------- | ----------------------------------------------------------- | | `teamId` | integer | ✅ | `12345` | The unique identifier of the team. | | `membershipId` | integer | ✅ | `111` | The unique identifier of the membership record to retrieve. | *** ### `Cal Retrieve Team Memberships` Integration name: **CAL\_RETRIEVE\_TEAM\_MEMBERSHIPS** Retrieves all memberships for a team, including member details, roles (`MEMBER`/`OWNER`/`ADMIN`), and invitation acceptance status. Supports pagination via `take` and `skip` parameters. Use this action to list team members and their roles. The authenticated user must be a member of the team to access its memberships. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ------------------------------------------------------------------------ | | `skip` | integer | | `0` | Number of membership records to skip before returning results. | | `take` | integer | | `10` | Maximum number of membership records to return. | | `teamId` | integer | ✅ | `12345` | The unique identifier of the team whose memberships are to be retrieved. | *** ### `Cal Retrieve Team Memberships For Organization` Integration name: **CAL\_RETRIEVE\_TEAM\_MEMBERSHIPS\_FOR\_ORGANIZATION** Retrieves all user memberships for a specific team within an organization, including each member's role (`OWNER`, `ADMIN`, `MEMBER`), acceptance status, impersonation settings, and detailed user information. Supports pagination via `take` and `skip` parameters. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | -------- | ----------------------------------------------------------------------- | | `skip` | integer | | `0` | Number of team memberships to skip for pagination offset. | | `take` | integer | | `50` | Maximum number of team memberships to return per page. | | `orgId` | integer | ✅ | `184337` | The unique numeric identifier of the organization containing the team | | `teamId` | integer | ✅ | `184336` | The unique numeric identifier of the team whose memberships to retrieve | *** ### `Cal Retrieve Users In Organization` Integration name: **CAL\_RETRIEVE\_USERS\_IN\_ORGANIZATION** Retrieves users associated with a specific organization ID, excluding individual scheduling or calendar data; the `orgId` must be a valid identifier for an existing organization. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ---------------------------------------------- | ---------------------------------------------------------------------- | | `skip` | integer | | — | Number of user records to skip for pagination. | | `take` | integer | | — | Maximum number of user records to return for pagination. | | `orgId` | integer | ✅ | — | The unique identifier of the organization for which to retrieve users. | | `emails` | array | | `"['user1@example.com', 'user2@example.com']"` | Optional list of email addresses to filter users by. | *** ### `Cal Retrieve V2 Conferencing Info` Integration name: **CAL\_RETRIEVE\_V2\_CONFERENCING\_INFO** Retrieves an authenticated Cal user's or organization's video conferencing configurations, capabilities, and installed apps, useful for understanding options before scheduling or verifying setups; provider availability may vary by subscription or settings. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Cal Retrieve Webhook Details For Oauth Client` Integration name: **CAL\_RETRIEVE\_WEBHOOK\_DETAILS\_FOR\_OAUTH\_CLIENT** Retrieves all webhook configurations for a specific OAuth client with optional pagination. This endpoint is part of Cal.com's Platform API for managing webhooks associated with OAuth clients. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------- | :------: | -------------------------- | -------------------------------------------------------------------------------- | | `skip` | integer | | `0` | The number of webhook details to skip. | | `take` | integer | | `10` | The maximum number of webhook details to return. | | `clientId` | string | ✅ | `"oauth_client_123xyz789"` | The unique identifier of the OAuth client for which to retrieve webhook details. | | `x_cal_secret_key` | string | | `"cal_secret_abc123xyz"` | The OAuth client secret key for authentication. | *** ### `Cal Retrieve Webhooks For Event Type` Integration name: **CAL\_RETRIEVE\_WEBHOOKS\_FOR\_EVENT\_TYPE** Retrieves a paginated list of webhooks (including URLs, subscribed events, and status) for a specified, existing event type ID, useful for auditing configurations or troubleshooting. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------- | | `skip` | integer | | `"0"` | Number of webhook records to skip (for pagination). | | `take` | integer | | `"10"` | Maximum number of webhook records to return (for pagination). | | `eventTypeId` | integer | ✅ | `"101"` | The unique identifier of the event type for which webhooks are to be retrieved. | *** ### `Cal Retrieve Webhooks List` Integration name: **CAL\_RETRIEVE\_WEBHOOKS\_LIST** Retrieves a paginated list of webhooks from the user's Cal scheduling system account, which are used for real-time notifications on events like new bookings, cancellations, or updates. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------- | :------: | ------- | ------------------------------------------------------------ | | `skip` | integer | | `0` | Number of webhook records to skip before collecting results. | | `take` | integer | | `10` | Maximum number of webhook records to return. | *** ### `Cal Save Calendar Entry` Integration name: **CAL\_SAVE\_CALENDAR\_ENTRY** Saves or updates a calendar's settings using a GET request, typically for data already on the server or simple updates via query parameters. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | -------------------------------------- | ------------------------------------------------------------------------------- | | `code` | string | ✅ | `"authorizationCodeFromOAuthProvider"` | Authorization code or token required to validate and permit the save operation. | | `state` | string | ✅ | `"aRandomSessionStateString12345"` | Client-provided opaque string to maintain state. | | `calendar` | string | ✅ | `"google"` | The calendar type to save or update. | *** ### `Cal Save Calendar Ics Feeds` Integration name: **CAL\_SAVE\_CALENDAR\_ICS\_FEEDS** Imports and saves one or more publicly accessible external iCalendar (ICS) feed URLs into the Cal.com calendar system. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ----------------------------------------- | ------------------------------------------------------------------------------------------------------- | | `urls` | array | ✅ | `"https://calendar.example.com/feed.ics"` | A list of iCalendar (ICS) feed URLs to be imported and saved. | | `readOnly` | boolean | | — | Specifies if the imported calendar events are read-only (`True`) or writable (`False`) via the Cal API. | *** ### `Cal Save Oauth Credentials Via Gcal Api` Integration name: **CAL\_SAVE\_OAUTH\_CREDENTIALS\_VIA\_GCAL\_API** Completes the Google Calendar OAuth 2.0 flow by exchanging the `code` and `state` (received from Google's redirect after user consent) for access and refresh tokens. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | `code` | string | ✅ | `"4/0AeaYSHAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"` | The authorization code received from the Google authorization server after the user has successfully authenticated and granted permissions. | | `state` | string | ✅ | `"_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"` | An opaque value used to maintain state between the initial authorization request to Stripe and the callback. | *** ### `Cal Save Stripe Details` Integration name: **CAL\_SAVE\_STRIPE\_DETAILS** Completes the Stripe OAuth flow by saving Stripe details; call this when a user is redirected back from Stripe with an authorization `code` and `state`. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | `code` | string | ✅ | `"ac_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"` | The authorization code returned by Stripe after the user successfully authorizes the Cal.com application. | | `state` | string | ✅ | `"random_string_for_csrf_prevention_123xyz"` | An opaque value used to maintain state between the initial authorization request to Stripe and the callback. | *** ### `Cal Set Default Conferencing App` Integration name: **CAL\_SET\_DEFAULT\_CONFERENCING\_APP** Sets the specified, valid, and configured conferencing application as the default for new meetings for the authenticated user. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | -------- | ----------------------------------------------------------------------------------------------------- | | `app` | string | ✅ | `"zoom"` | Identifier of a valid and configured conferencing application to set as the default for new meetings. | *** ### `Cal Update Destination Calendar Integration` Integration name: **CAL\_UPDATE\_DESTINATION\_CALENDAR\_INTEGRATION** Updates the destination calendar for syncing events, using `integration` and `externalId`. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | --------------------------------- | ----------------------------------------------------------------- | | `externalId` | string | ✅ | `"your_calendar_id_from_service"` | The unique identifier for the calendar within the chosen service. | | `integration` | string | ✅ | `"apple_calendar"` | The calendar service to integrate with. | *** ### `Cal Update Oauth Client User Settings` Integration name: **CAL\_UPDATE\_OAUTH\_CLIENT\_USER\_SETTINGS** Updates specified profile and scheduling preference fields for a user associated with an OAuth client; `defaultScheduleId`, if provided, must be an existing, valid schedule for the user. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | --------------------------------------------------- | ------------------------------------------------------- | | `bio` | string | | `"I am a software developer"` | User's biography or description text for their profile. | | `name` | string | | `"Jane Doe"` | New full name for the user. | | `email` | string | | `"new.email@example.com"` | New email address for the user. | | `locale` | string | | `"en"` | Preferred language and regional setting. | | `userId` | integer | ✅ | `12345` | Identifier for the user. | | `clientId` | string | ✅ | `"client_abc123"` | Identifier for the OAuth client. | | `metadata` | object | | `{"department":"Engineering"}` | Key-value metadata for storing custom user data. | | `timeZone` | string | | `"America/Los_Angeles"` | Preferred IANA Time Zone Database name. | | `avatarUrl` | string | | `"https://example.com/avatars/new_user_avatar.png"` | URL of the user's new avatar. | | `weekStart` | string | | `"Monday"` | First day of the user's week. | | `timeFormat` | integer | | `12` | Preferred time format. | | `x_cal_secret_key` | string | | `"cal_secret_abc123xyz"` | The OAuth client secret key for authentication. | | `defaultScheduleId` | integer | | `1` | ID of the user's default schedule. | *** ### `Cal Update Oauth Client Webhook` Integration name: **CAL\_UPDATE\_OAUTH\_CLIENT\_WEBHOOK** Updates specified properties of an existing webhook for an OAuth client; omitted fields remain unchanged. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------- | :------: | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | | `active` | boolean | | `true` | Specifies whether the webhook is active. | | `secret` | string | | `"myN3wS3cr3tKeyF0rW3bh00ks"` | A secret key for verifying webhook payload authenticity. | | `clientId` | string | ✅ | `"oauth_client_app_12345abcdef"` | The unique identifier of the OAuth client to which the webhook belongs. | | `triggers` | array | | `["BOOKING_RESCHEDULED"]` | The list of event types that will trigger this webhook. | | `webhookId` | string | ✅ | `"wh_67890ghijk_updated"` | The unique identifier of the webhook configuration to be updated. | | `subscriberUrl` | string | | `"https://api.example.com/calcom-webhooks/updated-endpoint"` | The URL where the webhook payload will be sent. | | `payloadTemplate` | string | | `"{\"event_type\": \"{{triggerEvent}}\", \"booking_id\": \"{{bookingId}}\", \"custom_field\": \"custom_value\"}"` | The template for the webhook payload. | | `x_cal_secret_key` | string | | `"cal_secret_abc123xyz"` | The OAuth client secret key required for Platform authentication. | *** ### `Cal Update Private Link` Integration name: **CAL\_UPDATE\_PRIVATE\_LINK** Updates a private link for a team event type within an organization. Use to modify `maxUsageCount` for usage-based links or `expiresAt` for time-based links. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------- | :------: | -------------------------- | ---------------------------------------------------------- | | `orgId` | integer | ✅ | `184337` | The unique identifier of the organization. | | `linkId` | string | ✅ | `"durF9BSn4cwU9wbMF9PmKo"` | The unique identifier of the private link to update. | | `teamId` | integer | ✅ | `184336` | The unique identifier of the team within the organization. | | `expiresAt` | string | | `"2024-12-31T23:59:59Z"` | Expiration date/time in ISO 8601 format. | | `eventTypeId` | integer | ✅ | `4591148` | The unique identifier of the event type. | | `maxUsageCount` | integer | | `10` | Maximum number of times the private link can be used. | *** ### `Cal Update Schedule By Id` Integration name: **CAL\_UPDATE\_SCHEDULE\_BY\_ID** Updates an existing schedule by its ID, allowing partial modification of properties; providing `availability` or `overrides` replaces them entirely. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ----------------------- | ----------------------------------------------------------------------- | | `name` | string | | `"My Work Schedule"` | Descriptive name for the schedule. | | `timeZone` | string | | `"America/Los_Angeles"` | IANA timezone string for the schedule. | | `isDefault` | boolean | | `true` | Set as the default schedule. | | `overrides` | array | | — | List of override objects for specific date/time adjustments. | | `scheduleId` | string | ✅ | `"sched_123xyz"` | The unique identifier of the schedule to be updated. | | `availability` | array | | — | List of availability objects for regular weekly recurring availability. | *** ### `Cal Update Team Event Type` Integration name: **CAL\_UPDATE\_TEAM\_EVENT\_TYPE** Tool to update a team event type in Cal.com. Use when modifying settings for a team's event type such as duration, description, scheduling, locations, or any other event configuration. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------------------------ | ------- | :------: | ------- | ---------------------------------------------------------------------------------------------- | | `slug` | string | | — | URL-friendly identifier | | `color` | object | | — | Theme color configuration. | | `hosts` | array | | — | Specific team members to assign. Do not use with `assignAllTeamMembers` | | `price` | integer | | — | Event price | | `seats` | object | | — | Multi-seat event configuration. | | `title` | string | | — | Event type title | | `hidden` | boolean | | — | Hide event type from public listing | | `teamId` | integer | ✅ | — | ID of the team | | `currency` | string | | — | Currency code | | `metadata` | object | | — | Custom metadata | | `locations` | array | | — | Meeting locations | | `customName` | string | | — | Customizable event name with variables like `{Event type title}`, `{Organiser}`, `{Scheduler}` | | `recurrence` | object | | — | Recurring event configuration. | | `scheduleId` | integer | | — | Custom schedule ID to use | | `description` | string | | — | Event type description | | `eventTypeId` | integer | ✅ | — | ID of the event type to update | | `offsetStart` | integer | | — | Offset timeslots by specified number of minutes | | `slotInterval` | integer | | — | Interval between available time slots in minutes | | `bookerLayouts` | object | | — | Calendar layout preferences for booker. | | `bookingFields` | array | | — | Complete set of booking form fields. Replaces all existing fields. | | `bookingWindow` | — | | — | Limit how far in future bookings can be made | | `disableGuests` | boolean | | — | Prevent attendees from adding guests | | `emailSettings` | object | | — | Email notification settings. | | `schedulingType` | string | | — | Team event scheduling types. | | `lengthInMinutes` | integer | | — | Duration of the event in minutes | | `afterEventBuffer` | integer | | — | Buffer time after event ends in minutes | | `calVideoSettings` | object | | — | Settings for Cal Video recordings and transcriptions. | | `beforeEventBuffer` | integer | | — | Buffer time before event starts in minutes | | `disableCancelling` | object | | — | Settings for disabling cancelling. | | `hideCalendarNotes` | boolean | | — | Hide notes from calendar events | | `interfaceLanguage` | string | | — | Supported interface languages for booking page. | | `bookingLimitsCount` | object | | — | Count-based booking limits. | | `confirmationPolicy` | object | | — | Manual confirmation policy configuration. | | `hideOrganizerEmail` | boolean | | — | Hide organizer email from booking screen and notifications | | `showOptimizedSlots` | boolean | | — | Optimize time slot arrangement for availability | | `successRedirectUrl` | string | | — | URL to redirect after successful booking | | `destinationCalendar` | object | | — | Destination calendar for bookings. | | `disableRescheduling` | object | | — | Settings for disabling rescheduling. | | `assignAllTeamMembers` | boolean | | — | Assign all current and future team members. Do not use with `hosts` | | `minimumBookingNotice` | integer | | — | Minimum minutes before event for booking | | `bookingLimitsDuration` | object | | — | Duration-based booking limits. | | `lengthInMinutesOptions` | array | | — | Multiple duration options, must include `lengthInMinutes` | | `hideCalendarEventDetails` | boolean | | — | Hide event details from calendar | | `bookerActiveBookingsLimit` | — | | — | Limit concurrent active bookings per booker | | `onlyShowFirstAvailableSlot` | boolean | | — | Show only earliest available slot per day | | `useDestinationCalendarEmail` | boolean | | — | Use destination calendar email | | `allowReschedulingPastBookings` | boolean | | — | Allow rescheduling of past events | | `bookingRequiresAuthentication` | boolean | | — | Require authentication for booking, only owner/org admin can book | | `lockTimeZoneToggleOnBookingPage` | boolean | | — | Prevent timezone changes on booking page | | `requiresBookerEmailVerification` | boolean | | — | Require email verification before booking | | `rescheduleWithSameRoundRobinHost` | boolean | | — | Keep same host when rescheduling round robin | | `allowReschedulingCancelledBookings` | boolean | | — | Allow rebooking cancelled events | *** ### `Cal Update Team Event Type Webhook` Integration name: **CAL\_UPDATE\_TEAM\_EVENT\_TYPE\_WEBHOOK** Updates a webhook for a team event type. Use when you need to modify webhook configuration like active status, subscriber URL, triggers, or payload template. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | | `active` | boolean | | `true` | Set to true to activate the webhook or false to deactivate it. | | `secret` | string | | `"my-secret-key"` | Secret key used to sign the webhook payload for verification. | | `teamId` | integer | ✅ | `184346` | The unique identifier of the team. | | `version` | string | | `"2021-10-20"` | Webhook version. | | `triggers` | array | | `["BOOKING_CREATED","BOOKING_CANCELLED","BOOKING_RESCHEDULED"]` | List of event types that will trigger this webhook. | | `webhookId` | string | ✅ | `"bd473e95-5964-449f-a625-ee182baf6aa3"` | The unique identifier of the webhook to update. | | `eventTypeId` | integer | ✅ | `4749816` | The unique identifier of the event type within the team. | | `subscriberUrl` | string | | `"https://webhook.site/updated-webhook"` | The URL endpoint where webhook events will be sent via POST requests. | | `payloadTemplate` | string | | `"{\"content\":\"A new event has been scheduled\",\"type\":\"{{type}}\",\"name\":\"{{title}}\",\"organizer\":\"{{organizer.name}}\",\"booker\":\"{{attendees.0.name}}\"}"` | Custom template for the webhook payload. | *** ### `Cal Update Team Information By Id` Integration name: **CAL\_UPDATE\_TEAM\_INFORMATION\_BY\_ID** Updates an existing team's information by its ID within a specified organization; the `slug`, if provided, must be unique within the organization. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------------------ | ------- | :------: | ---------------------------------------------- | --------------------------------------------------------------------------------- | | `bio` | string | | `"The best sales team in the world!"` | New short description or biography for the team. | | `name` | string | | `"Sales Team"` | New name for the team. | | `slug` | string | | `"sales-team"` | New URL-friendly identifier for the team; must be unique within the organization. | | `orgId` | integer | ✅ | — | ID of the organization to which the team belongs. | | `theme` | string | | `"dark"` | Visual theme for the team's booking pages. | | `teamId` | integer | ✅ | — | ID of the team to update. | | `appLogo` | string | | `"https://example.com/new_app_logo.png"` | URL for the new logo to be displayed within the Cal.com application. | | `logoUrl` | string | | `"https://example.com/new_logo.png"` | URL for the team's new logo image. | | `metadata` | object | | — | Custom key-value metadata for the team. | | `timeZone` | string | | `"America/New_York"` | Default IANA timezone identifier for the team. | | `bannerUrl` | string | | `"https://example.com/new_banner.jpg"` | URL for the team's new banner image. | | `isPrivate` | boolean | | `true` | Set to true to make the team private. | | `weekStart` | string | | `"Sunday"` | Designated start day of the week for the team's calendar views. | | `brandColor` | string | | `"#FF5733"` | New primary brand color for the team. | | `timeFormat` | integer | | `12` | Preferred time format. | | `appIconLogo` | string | | `"https://example.com/new_app_icon.png"` | URL for the new icon logo to be displayed within the Cal.com application. | | `calVideoLogo` | string | | `"https://example.com/new_cal_video_logo.png"` | URL for the new logo to be displayed in Cal Video calls. | | `hideBranding` | boolean | | `true` | Set to true to hide Cal.com branding from the team's booking pages. | | `bookingLimits` | object | | — | Booking limits, conforming to Cal.com's schema. | | `darkBrandColor` | string | | `"#C70039"` | New brand color for dark mode. | | `hideBookATeamMember` | boolean | | `true` | Set to true to hide the `Book a Team Member` option on the team's booking page. | | `includeManagedEventsInLimits` | boolean | | `true` | Set to true to include team-managed events when calculating booking limits. | *** ### `Cal Update Team Membership By Id` Integration name: **CAL\_UPDATE\_TEAM\_MEMBERSHIP\_BY\_ID** Updates properties of an existing team membership. Supports partial updates - only provided fields are modified while others remain unchanged. Requires appropriate team permissions (admin or owner role). Use `Get teams list` to find teamId and `Retrieve team memberships` to find membershipId. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ---------- | ------------------------------------------------------------------------------------------ | | `role` | string | | `"MEMBER"` | The role to assign to the team member. | | `teamId` | integer | ✅ | — | The unique identifier of the team. | | `accepted` | boolean | | `true` | Set to true to mark the membership invitation as accepted, or false to mark it as pending. | | `membershipId` | integer | ✅ | — | The unique identifier of the membership to update. | | `disableImpersonation` | boolean | | `true` | Set to true to prevent team administrators from impersonating this member. | *** ### `Cal Update Team Membership Properties` Integration name: **CAL\_UPDATE\_TEAM\_MEMBERSHIP\_PROPERTIES** Updates attributes like acceptance status, role, or impersonation settings for an existing team membership within an organization. Only provided fields are changed (partial update). Requires organization admin or owner privileges. Use list memberships endpoint to get valid `membershipId` values. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ---------- | ------------------------------------------------------------------------------------------ | | `role` | string | | `"MEMBER"` | The role to assign to the team member. | | `orgId` | integer | ✅ | — | The unique identifier of the organization to which the team belongs. | | `teamId` | integer | ✅ | — | The unique identifier of the team within the organization. | | `accepted` | boolean | | `true` | Set to true to mark the membership invitation as accepted, or false to mark it as pending. | | `membershipId` | integer | ✅ | — | The unique identifier of the team membership to be updated. | | `disableImpersonation` | boolean | | `true` | Set to true to prevent administrators from impersonating this team member. | *** ### `Cal Update User Profile Details` Integration name: **CAL\_UPDATE\_USER\_PROFILE\_DETAILS** Updates the profile information and preferences for the authenticated user, affecting only the fields provided in the request. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------- | ------- | :------: | ---------------------------------- | ---------------------------------------------------- | | `name` | string | | `"Jane Doe"` | The user's new full name. | | `email` | string | | `"new.email@example.com"` | The user's new email address. | | `locale` | string | | `"en"` | The user's preferred language and regional settings. | | `timeZone` | string | | `"America/New_York"` | The user's preferred time zone. | | `avatarUrl` | string | | `"https://example.com/avatar.jpg"` | The URL of the user's new avatar image. | | `weekStart` | string | | `"Monday"` | The preferred start day of the week for the user. | | `timeFormat` | integer | | `"12"` | The preferred time format for the user. | | `defaultScheduleId` | integer | | `"1"` | The ID of the user's default schedule. | *** ### `Cal Update User Schedule In Organization` Integration name: **CAL\_UPDATE\_USER\_SCHEDULE\_IN\_ORGANIZATION** Modifies an existing schedule for a specified user within an organization by updating only the provided fields; the organization, user, and schedule must already exist. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ----------------------- | ------------------------------------------------------------------ | | `name` | string | | `"Weekday Work Hours"` | New name for the schedule. | | `orgId` | integer | ✅ | — | Unique identifier for the organization. | | `userId` | integer | ✅ | — | Unique identifier for the user. | | `timeZone` | string | | `"America/Los_Angeles"` | New IANA time zone identifier for the schedule. | | `isDefault` | boolean | | — | If true, sets this schedule as the user's default. | | `overrides` | array | | — | Date-specific overrides to regular availability. | | `scheduleId` | integer | ✅ | — | Unique identifier for the schedule. | | `availability` | array | | — | Regular availability rules defining the recurring weekly schedule. | *** ### `Cal Update Webhook By Id` Integration name: **CAL\_UPDATE\_WEBHOOK\_BY\_ID** Updates an existing Cal.com webhook by its `webhookId`, allowing partial modification of its attributes; only explicitly provided fields will be changed. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ----------------------------------------------------------------------- | --------------------------------------------------------------------- | | `active` | boolean | | `true` | Specifies if the webhook is active (`true`) or inactive (`false`). | | `secret` | string | | `"mySuperSecretKey123"` | Secret key to sign the webhook payload for authenticity verification. | | `triggers` | array | | `["BOOKING_CREATED"]` | List of event types that trigger the webhook. | | `webhookId` | string | ✅ | `"wh_clxone65x0000mc0k5x9n3f7y"` | The unique identifier of the webhook to be updated. | | `subscriberUrl` | string | | `"https://api.example.com/webhook-receiver"` | URL where the webhook payload will be sent. | | `payloadTemplate` | string | | `"{\"event\": \"{{triggerEvent}}\", \"createdAt\": \"{{createdAt}}\"}"` | Template for the payload sent to `subscriberUrl`. | *** ### `Cal Update Webhook For Organization` Integration name: **CAL\_UPDATE\_WEBHOOK\_FOR\_ORGANIZATION** Updates an existing webhook for an organization. Use this to modify webhook settings such as the subscriber URL, activation status, event triggers, or verification secret. Requires admin access to the organization. Only fields provided in the request will be updated; omitted fields retain their current values. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ----------------------------------------------------------- | ------------------------------------------------------------------ | | `orgId` | integer | ✅ | `123` | Unique identifier of the organization the webhook belongs to. | | `active` | boolean | | `"true"` | Whether the webhook is active. | | `secret` | string | | `"mysecretkey"` | Secret key to sign the payload for verification using HMAC SHA256. | | `triggers` | array | | `["BOOKING_CREATED"]` | List of event types that trigger the webhook. | | `webhookId` | string | ✅ | `"wh_clx08gf5g000008l3fdgy9jlo"` | Unique identifier of the webhook to update. | | `subscriberUrl` | string | | `"https://api.example.com/webhook-receiver"` | URL where webhook notifications are sent. | | `payloadTemplate` | string | | `"{\"event\": \"{{trigger}}\", \"data\": \"{{payload}}\"}"` | Custom template for the webhook payload. | *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.toolhouse.ai/toolhouse/integrations/cal.com.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.