cal-event-types - Pinkfish - AI Agents & Workflows for Getting Work Done

Server path: /cal-event-types | Type: Application | PCID required: Yes

Tools

Tool	Description
`cal_event_types_controller_2024_06_14_create_event_type`	Create an event type
`cal_event_types_controller_2024_06_14_delete_event_type`	Delete an event type
`cal_event_types_controller_2024_06_14_get_event_type_by_id`	Get an event type
`cal_event_types_controller_2024_06_14_get_event_types`	Get all event types
`cal_event_types_controller_2024_06_14_update_event_type`	Update an event type
`cal_event_types_type_webhooks_controller_create_event_type_webhook`	Create a webhook
`cal_event_types_type_webhooks_controller_delete_all_event_type_webhooks`	Delete all webhooks
`cal_event_types_type_webhooks_controller_delete_event_type_webhook`	Delete a webhook
`cal_event_types_type_webhooks_controller_get_event_type_webhook`	Get a webhook
`cal_event_types_type_webhooks_controller_get_event_type_webhooks`	Get all webhooks
`cal_event_types_type_webhooks_controller_update_event_type_webhook`	Update a webhook

cal_event_types_controller_2024_06_14_create_event_type

Create an event type Parameters:

Parameter	Type	Required	Default	Description
`cal-api-version`	string	Yes	—	Must be set to 2024-06-14. If not set to this value, the endpoint will default to an older version.
`afterEventBuffer`	number	No	—	Extra time automatically blocked on your calendar after a meeting ends. This gives you time to wrap up, add notes, or decompress before your next commitment.
`allowReschedulingCancelledBookings`	boolean	No	—	When enabled, users will be able to create a new booking when trying to reschedule a cancelled booking.
`allowReschedulingPastBookings`	boolean	No	—	Enabling this option allows for past events to be rescheduled.
`beforeEventBuffer`	number	No	—	Extra time automatically blocked on your calendar before a meeting starts. This gives you time to prepare, review notes, or transition from your previous activity.
`bookerActiveBookingsLimit`	object	No	—	Limit the number of active bookings a booker can make for this event type.
`bookerLayouts`	object	No	—	Should booker have week, month or column view. Specify default layout and enabled layouts user can pick.
`bookingFields`	any[]	No	—	Custom fields that can be added to the booking form when the event is booked by someone. By default booking form has name and email field.
`bookingLimitsCount`	object	No	—	Limit how many times this event can be booked
`bookingLimitsDuration`	object	No	—	Limit total amount of time that this event can be booked
`bookingRequiresAuthentication`	boolean	No	—	Boolean to require authentication for booking this event type via api. If true, only authenticated users who are the event-type owner or org/team admin/owner can book this event type.
`bookingWindow`	object	No	—	Limit how far in the future this event can be booked
`calVideoSettings`	object	No	—	Cal video settings for the event type. Platform customers can’t manage this property because currently we have no way of determining if managed user is a host or an attendee.
`color`	object	No	—	The color value
`confirmationPolicy`	object	No	—	Specify how the booking needs to be manually confirmed before it is pushed to the integrations and a confirmation mail is sent.
`customName`	string	No	—	Customizable event name with valid variables: {Event type title}, {Organiser}, {Scheduler}, {Location}, {Organiser first name}, {Scheduler first name}, {Scheduler last name}, {Event duration}, {LOCATION}, {HOST/ATTENDEE}, {HOST}, {ATTENDEE}, {USER}
`description`	string	No	—	The description value
`destinationCalendar`	object	No	—	Destination Calendar
`disableCancelling`	object	No	—	Settings for disabling cancelling of this event type.
`disableGuests`	boolean	No	—	If true, person booking this event can’t add guests via their emails.
`disableRescheduling`	object	No	—	Settings for disabling rescheduling of this event type. Can be always disabled or disabled when less than X minutes before the meeting.
`hidden`	boolean	No	—	The hidden value
`hideCalendarEventDetails`	boolean	No	—	Hide Calendar Event Details
`hideCalendarNotes`	boolean	No	—	Hide Calendar Notes
`hideOrganizerEmail`	boolean	No	—	Boolean to Hide organizer’s email address from the booking screen, email notifications, and calendar events
`interfaceLanguage`	string	No	—	Set preferred language for the booking interface. Use empty string for visitor’s browser language (default).
`lengthInMinutes`	number	Yes	—	Length In Minutes
`lengthInMinutesOptions`	string[]	No	—	If you want that user can choose between different lengths of the event you can specify them here. Must include the provided `lengthInMinutes`.
`locations`	any[]	No	—	Locations where the event will take place. If not provided, cal video link will be used as the location. Note: Setting a location to a conferencing app does not install the app - the app must already be installed. Via API, only Google Meet (google-meet), Microsoft Teams (office365-video), and Zoom (zoom) can be installed. Cal Video (cal-video) is installed by default. All other conferencing apps must be connected via the Cal.com web app and are not available for Platform plan customers. You can only set an event type location to an app that has already been installed or connected.
`lockTimeZoneToggleOnBookingPage`	boolean	No	—	Lock Time Zone Toggle On Booking Page
`minimumBookingNotice`	number	No	—	Minimum number of minutes before the event that a booking can be made.
`offsetStart`	number	No	—	Offset timeslots shown to bookers by a specified number of minutes
`onlyShowFirstAvailableSlot`	boolean	No	—	This will limit your availability for this event type to one slot per day, scheduled at the earliest available time.
`recurrence`	object	No	—	Create a recurring event type.
`requiresBookerEmailVerification`	boolean	No	—	Requires Booker Email Verification
`scheduleId`	number	No	—	If you want that this event has different schedule than user’s default one you can specify it here.
`seats`	object	No	—	Create an event type with multiple seats.
`showOptimizedSlots`	boolean	No	—	Arrange time slots to optimize availability.
`slotInterval`	number	No	—	Number representing length of each slot when event is booked. By default it equal length of the event type. If event length is 60 minutes then we would have slots 9AM, 10AM, 11AM etc. but if it was changed to 30 minutes then we would have slots 9AM, 9:30AM, 10AM, 10:30AM etc. as the available times to book the 60 minute event.
`slug`	string	Yes	—	The slug value
`successRedirectUrl`	string	No	—	A valid URL where the booker will redirect to, once the booking is completed successfully
`title`	string	Yes	—	The title value
`useDestinationCalendarEmail`	boolean	No	—	Use Destination Calendar Email

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "cal-api-version": {
      "type": "string",
      "description": "Must be set to 2024-06-14. If not set to this value, the endpoint will default to an older version."
    },
    "afterEventBuffer": {
      "type": "number",
      "description": "Extra time automatically blocked on your calendar after a meeting ends. This gives you time to wrap up, add notes, or decompress before your next commitment."
    },
    "allowReschedulingCancelledBookings": {
      "type": "boolean",
      "description": "When enabled, users will be able to create a new booking when trying to reschedule a cancelled booking."
    },
    "allowReschedulingPastBookings": {
      "type": "boolean",
      "description": "Enabling this option allows for past events to be rescheduled."
    },
    "beforeEventBuffer": {
      "type": "number",
      "description": "Extra time automatically blocked on your calendar before a meeting starts. This gives you time to prepare, review notes, or transition from your previous activity."
    },
    "bookerActiveBookingsLimit": {
      "description": "Limit the number of active bookings a booker can make for this event type."
    },
    "bookerLayouts": {
      "description": "Should booker have week, month or column view. Specify default layout and enabled layouts user can pick."
    },
    "bookingFields": {
      "type": "array",
      "description": "Custom fields that can be added to the booking form when the event is booked by someone. By default booking form has name and email field."
    },
    "bookingLimitsCount": {
      "description": "Limit how many times this event can be booked"
    },
    "bookingLimitsDuration": {
      "description": "Limit total amount of time that this event can be booked"
    },
    "bookingRequiresAuthentication": {
      "type": "boolean",
      "description": "Boolean to require authentication for booking this event type via api. If true, only authenticated users who are the event-type owner or org/team admin/owner can book this event type."
    },
    "bookingWindow": {
      "description": "Limit how far in the future this event can be booked"
    },
    "calVideoSettings": {
      "description": "Cal video settings for the event type. Platform customers can't manage this property because currently we have no way of determining if managed user is a host or an attendee."
    },
    "color": {
      "type": "object",
      "description": "The color value",
      "properties": {
        "lightThemeHex": {
          "type": "string",
          "description": "Color used for event types in light theme"
        },
        "darkThemeHex": {
          "type": "string",
          "description": "Color used for event types in dark theme"
        }
      },
      "required": [
        "lightThemeHex",
        "darkThemeHex"
      ]
    },
    "confirmationPolicy": {
      "description": "Specify how the booking needs to be manually confirmed before it is pushed to the integrations and a confirmation mail is sent."
    },
    "customName": {
      "type": "string",
      "description": "Customizable event name with valid variables:       {Event type title}, {Organiser}, {Scheduler}, {Location}, {Organiser first name},       {Scheduler first name}, {Scheduler last name}, {Event duration}, {LOCATION},       {HOST/ATTENDEE}, {HOST}, {ATTENDEE}, {USER}"
    },
    "description": {
      "type": "string",
      "description": "The description value"
    },
    "destinationCalendar": {
      "type": "object",
      "description": "Destination Calendar",
      "properties": {
        "integration": {
          "type": "string",
          "description": "The integration type of the destination calendar. Refer to the /api/v2/calendars endpoint to retrieve the integration type of your connected calendars."
        },
        "externalId": {
          "type": "string",
          "description": "The external ID of the destination calendar. Refer to the /api/v2/calendars endpoint to retrieve the external IDs of your connected calendars."
        }
      },
      "required": [
        "integration",
        "externalId"
      ]
    },
    "disableCancelling": {
      "description": "Settings for disabling cancelling of this event type."
    },
    "disableGuests": {
      "type": "boolean",
      "description": "If true, person booking this event can't add guests via their emails."
    },
    "disableRescheduling": {
      "description": "Settings for disabling rescheduling of this event type. Can be always disabled or disabled when less than X minutes before the meeting."
    },
    "hidden": {
      "type": "boolean",
      "description": "The hidden value"
    },
    "hideCalendarEventDetails": {
      "type": "boolean",
      "description": "Hide Calendar Event Details"
    },
    "hideCalendarNotes": {
      "type": "boolean",
      "description": "Hide Calendar Notes"
    },
    "hideOrganizerEmail": {
      "type": "boolean",
      "description": "Boolean to Hide organizer's email address from the booking screen, email notifications, and calendar events"
    },
    "interfaceLanguage": {
      "type": "string",
      "description": "Set preferred language for the booking interface. Use empty string for visitor's browser language (default).",
      "enum": [
        "",
        "en",
        "ar",
        "az",
        "bg",
        "bn",
        "ca",
        "cs",
        "da",
        "de",
        "el",
        "es",
        "es-419",
        "eu",
        "et",
        "fi",
        "fr",
        "he",
        "hu",
        "it",
        "ja",
        "km",
        "ko",
        "nl",
        "no",
        "pl",
        "pt-BR",
        "pt",
        "ro",
        "ru",
        "sk-SK",
        "sr",
        "sv",
        "tr",
        "uk",
        "vi",
        "zh-CN",
        "zh-TW"
      ]
    },
    "lengthInMinutes": {
      "type": "number",
      "description": "Length In Minutes"
    },
    "lengthInMinutesOptions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "If you want that user can choose between different lengths of the event you can specify them here. Must include the provided `lengthInMinutes`."
    },
    "locations": {
      "type": "array",
      "description": "Locations where the event will take place. If not provided, cal video link will be used as the location. Note: Setting a location to a conferencing app does not install the app - the app must already be installed. Via API, only Google Meet (google-meet), Microsoft Teams (office365-video), and Zoom (zoom) can be installed. Cal Video (cal-video) is installed by default. All other conferencing apps must be connected via the Cal.com web app and are not available for Platform plan customers. You can only set an event type location to an app that has already been installed or connected."
    },
    "lockTimeZoneToggleOnBookingPage": {
      "type": "boolean",
      "description": "Lock Time Zone Toggle On Booking Page"
    },
    "minimumBookingNotice": {
      "type": "number",
      "description": "Minimum number of minutes before the event that a booking can be made."
    },
    "offsetStart": {
      "type": "number",
      "description": "Offset timeslots shown to bookers by a specified number of minutes"
    },
    "onlyShowFirstAvailableSlot": {
      "type": "boolean",
      "description": "This will limit your availability for this event type to one slot per day, scheduled at the earliest available time."
    },
    "recurrence": {
      "description": "Create a recurring event type."
    },
    "requiresBookerEmailVerification": {
      "type": "boolean",
      "description": "Requires Booker Email Verification"
    },
    "scheduleId": {
      "type": "number",
      "description": "If you want that this event has different schedule than user's default one you can specify it here."
    },
    "seats": {
      "description": "Create an event type with multiple seats."
    },
    "showOptimizedSlots": {
      "type": "boolean",
      "description": "Arrange time slots to optimize availability."
    },
    "slotInterval": {
      "type": "number",
      "description": "Number representing length of each slot when event is booked. By default it equal length of the event type.       If event length is 60 minutes then we would have slots 9AM, 10AM, 11AM etc. but if it was changed to 30 minutes then       we would have slots 9AM, 9:30AM, 10AM, 10:30AM etc. as the available times to book the 60 minute event."
    },
    "slug": {
      "type": "string",
      "description": "The slug value"
    },
    "successRedirectUrl": {
      "type": "string",
      "description": "A valid URL where the booker will redirect to, once the booking is completed successfully"
    },
    "title": {
      "type": "string",
      "description": "The title value"
    },
    "useDestinationCalendarEmail": {
      "type": "boolean",
      "description": "Use Destination Calendar Email"
    }
  },
  "required": [
    "PCID",
    "cal-api-version",
    "lengthInMinutes",
    "slug",
    "title"
  ]
}

cal_event_types_controller_2024_06_14_delete_event_type

Delete an event type Parameters:

Parameter	Type	Required	Default	Description
`cal-api-version`	string	Yes	—	Must be set to 2024-06-14. If not set to this value, the endpoint will default to an older version.
`eventTypeId`	number	Yes	—	Event Type Id

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "cal-api-version": {
      "type": "string",
      "description": "Must be set to 2024-06-14. If not set to this value, the endpoint will default to an older version."
    },
    "eventTypeId": {
      "type": "number",
      "description": "Event Type Id"
    }
  },
  "required": [
    "PCID",
    "cal-api-version",
    "eventTypeId"
  ]
}

cal_event_types_controller_2024_06_14_get_event_type_by_id

Get an event type Parameters:

Parameter	Type	Required	Default	Description
`cal-api-version`	string	Yes	—	Must be set to 2024-06-14. If not set to this value, the endpoint will default to an older version.
`eventTypeId`	number	Yes	—	Event Type Id

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "cal-api-version": {
      "type": "string",
      "description": "Must be set to 2024-06-14. If not set to this value, the endpoint will default to an older version."
    },
    "eventTypeId": {
      "type": "number",
      "description": "Event Type Id"
    }
  },
  "required": [
    "PCID",
    "cal-api-version",
    "eventTypeId"
  ]
}

cal_event_types_controller_2024_06_14_get_event_types

Get all event types Parameters:

Parameter	Type	Required	Default	Description
`cal-api-version`	string	Yes	—	Must be set to 2024-06-14. If not set to this value, the endpoint will default to an older version.
`username`	string	No	—	The username of the user to get event types for. If only username provided will get all event types.
`eventSlug`	string	No	—	Slug of event type to return. Notably, if eventSlug is provided then username must be provided too, because multiple users can have event with same slug.
`usernames`	string	No	—	Get dynamic event type for multiple usernames separated by comma. e.g `usernames=alice,bob`
`orgSlug`	string	No	—	slug of the user’s organization if he is in one, orgId is not required if using this parameter
`orgId`	number	No	—	ID of the organization of the user you want the get the event-types of, orgSlug is not needed when using this parameter
`sortCreatedAt`	string	No	—	Sort event types by creation date. When not provided, no explicit ordering is applied.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "cal-api-version": {
      "type": "string",
      "description": "Must be set to 2024-06-14. If not set to this value, the endpoint will default to an older version."
    },
    "username": {
      "type": "string",
      "description": "The username of the user to get event types for. If only username provided will get all event types."
    },
    "eventSlug": {
      "type": "string",
      "description": "Slug of event type to return. Notably, if eventSlug is provided then username must be provided too, because multiple users can have event with same slug."
    },
    "usernames": {
      "type": "string",
      "description": "Get dynamic event type for multiple usernames separated by comma. e.g `usernames=alice,bob`"
    },
    "orgSlug": {
      "type": "string",
      "description": "slug of the user's organization if he is in one, orgId is not required if using this parameter"
    },
    "orgId": {
      "type": "number",
      "description": "ID of the organization of the user you want the get the event-types of, orgSlug is not needed when using this parameter"
    },
    "sortCreatedAt": {
      "type": "string",
      "description": "Sort event types by creation date. When not provided, no explicit ordering is applied.",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "required": [
    "PCID",
    "cal-api-version"
  ]
}

cal_event_types_controller_2024_06_14_update_event_type

Update an event type Parameters:

Parameter	Type	Required	Default	Description
`cal-api-version`	string	Yes	—	Must be set to 2024-06-14. If not set to this value, the endpoint will default to an older version.
`eventTypeId`	number	Yes	—	Event Type Id
`afterEventBuffer`	number	No	—	Extra time automatically blocked on your calendar after a meeting ends. This gives you time to wrap up, add notes, or decompress before your next commitment.
`allowReschedulingCancelledBookings`	boolean	No	—	When enabled, users will be able to create a new booking when trying to reschedule a cancelled booking.
`allowReschedulingPastBookings`	boolean	No	—	Enabling this option allows for past events to be rescheduled.
`beforeEventBuffer`	number	No	—	Extra time automatically blocked on your calendar before a meeting starts. This gives you time to prepare, review notes, or transition from your previous activity.
`bookerActiveBookingsLimit`	object	No	—	Limit the number of active bookings a booker can make for this event type.
`bookerLayouts`	object	No	—	Should booker have week, month or column view. Specify default layout and enabled layouts user can pick.
`bookingFields`	any[]	No	—	Complete set of booking form fields. This array replaces all existing booking fields. To modify existing fields, first fetch the current event type, then include all desired fields in this array. Sending only one field will remove all other custom fields, keeping only default fields plus the provided one.
`bookingLimitsCount`	object	No	—	Limit how many times this event can be booked
`bookingLimitsDuration`	object	No	—	Limit total amount of time that this event can be booked
`bookingRequiresAuthentication`	boolean	No	—	Boolean to require authentication for booking this event type via api. If true, only authenticated users who are the event-type owner or org/team admin/owner can book this event type.
`bookingWindow`	object	No	—	Limit how far in the future this event can be booked
`calVideoSettings`	object	No	—	Cal video settings for the event type
`color`	object	No	—	The color value
`confirmationPolicy`	object	No	—	Specify how the booking needs to be manually confirmed before it is pushed to the integrations and a confirmation mail is sent.
`customName`	string	No	—	Customizable event name with valid variables: {Event type title}, {Organiser}, {Scheduler}, {Location}, {Organiser first name}, {Scheduler first name}, {Scheduler last name}, {Event duration}, {LOCATION}, {HOST/ATTENDEE}, {HOST}, {ATTENDEE}, {USER}
`description`	string	No	—	The description value
`destinationCalendar`	object	No	—	Destination Calendar
`disableCancelling`	object	No	—	Settings for disabling cancelling of this event type.
`disableGuests`	boolean	No	—	If true, person booking this event can’t add guests via their emails.
`disableRescheduling`	object	No	—	Settings for disabling rescheduling of this event type. Can be always disabled or disabled when less than X minutes before the meeting.
`hidden`	boolean	No	—	The hidden value
`hideCalendarEventDetails`	boolean	No	—	Hide Calendar Event Details
`hideCalendarNotes`	boolean	No	—	Hide Calendar Notes
`hideOrganizerEmail`	boolean	No	—	Boolean to Hide organizer’s email address from the booking screen, email notifications, and calendar events
`interfaceLanguage`	string	No	—	Set preferred language for the booking interface. Use empty string for visitor’s browser language (default).
`lengthInMinutes`	number	No	—	Length In Minutes
`lengthInMinutesOptions`	string[]	No	—	If you want that user can choose between different lengths of the event you can specify them here. Must include the provided `lengthInMinutes`.
`locations`	any[]	No	—	Locations where the event will take place. If not provided, cal video link will be used as the location. Note: Setting a location to a conferencing app does not install the app - the app must already be installed. Via API, only Google Meet (google-meet), Microsoft Teams (office365-video), and Zoom (zoom) can be installed. Cal Video (cal-video) is installed by default. All other conferencing apps must be connected via the Cal.com web app and are not available for Platform plan customers. You can only set an event type location to an app that has already been installed or connected.
`lockTimeZoneToggleOnBookingPage`	boolean	No	—	Lock Time Zone Toggle On Booking Page
`minimumBookingNotice`	number	No	—	Minimum number of minutes before the event that a booking can be made.
`offsetStart`	number	No	—	Offset timeslots shown to bookers by a specified number of minutes
`onlyShowFirstAvailableSlot`	boolean	No	—	This will limit your availability for this event type to one slot per day, scheduled at the earliest available time.
`recurrence`	object	No	—	Create a recurring event type.
`requiresBookerEmailVerification`	boolean	No	—	Requires Booker Email Verification
`scheduleId`	number	No	—	If you want that this event has different schedule than user’s default one you can specify it here.
`seats`	object	No	—	Create an event type with multiple seats.
`showOptimizedSlots`	boolean	No	—	Arrange time slots to optimize availability.
`slotInterval`	number	No	—	Number representing length of each slot when event is booked. By default it equal length of the event type. If event length is 60 minutes then we would have slots 9AM, 10AM, 11AM etc. but if it was changed to 30 minutes then we would have slots 9AM, 9:30AM, 10AM, 10:30AM etc. as the available times to book the 60 minute event.
`slug`	string	No	—	The slug value
`successRedirectUrl`	string	No	—	A valid URL where the booker will redirect to, once the booking is completed successfully
`title`	string	No	—	The title value
`useDestinationCalendarEmail`	boolean	No	—	Use Destination Calendar Email

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "cal-api-version": {
      "type": "string",
      "description": "Must be set to 2024-06-14. If not set to this value, the endpoint will default to an older version."
    },
    "eventTypeId": {
      "type": "number",
      "description": "Event Type Id"
    },
    "afterEventBuffer": {
      "type": "number",
      "description": "Extra time automatically blocked on your calendar after a meeting ends. This gives you time to wrap up, add notes, or decompress before your next commitment."
    },
    "allowReschedulingCancelledBookings": {
      "type": "boolean",
      "description": "When enabled, users will be able to create a new booking when trying to reschedule a cancelled booking."
    },
    "allowReschedulingPastBookings": {
      "type": "boolean",
      "description": "Enabling this option allows for past events to be rescheduled."
    },
    "beforeEventBuffer": {
      "type": "number",
      "description": "Extra time automatically blocked on your calendar before a meeting starts. This gives you time to prepare, review notes, or transition from your previous activity."
    },
    "bookerActiveBookingsLimit": {
      "description": "Limit the number of active bookings a booker can make for this event type."
    },
    "bookerLayouts": {
      "description": "Should booker have week, month or column view. Specify default layout and enabled layouts user can pick."
    },
    "bookingFields": {
      "type": "array",
      "description": "Complete set of booking form fields. This array replaces all existing booking fields. To modify existing fields, first fetch the current event type, then include all desired fields in this array. Sending only one field will remove all other custom fields, keeping only default fields plus the provided one."
    },
    "bookingLimitsCount": {
      "description": "Limit how many times this event can be booked"
    },
    "bookingLimitsDuration": {
      "description": "Limit total amount of time that this event can be booked"
    },
    "bookingRequiresAuthentication": {
      "type": "boolean",
      "description": "Boolean to require authentication for booking this event type via api. If true, only authenticated users who are the event-type owner or org/team admin/owner can book this event type."
    },
    "bookingWindow": {
      "description": "Limit how far in the future this event can be booked"
    },
    "calVideoSettings": {
      "description": "Cal video settings for the event type"
    },
    "color": {
      "type": "object",
      "description": "The color value",
      "properties": {
        "lightThemeHex": {
          "type": "string",
          "description": "Color used for event types in light theme"
        },
        "darkThemeHex": {
          "type": "string",
          "description": "Color used for event types in dark theme"
        }
      },
      "required": [
        "lightThemeHex",
        "darkThemeHex"
      ]
    },
    "confirmationPolicy": {
      "description": "Specify how the booking needs to be manually confirmed before it is pushed to the integrations and a confirmation mail is sent."
    },
    "customName": {
      "type": "string",
      "description": "Customizable event name with valid variables:       {Event type title}, {Organiser}, {Scheduler}, {Location}, {Organiser first name},       {Scheduler first name}, {Scheduler last name}, {Event duration}, {LOCATION},       {HOST/ATTENDEE}, {HOST}, {ATTENDEE}, {USER}"
    },
    "description": {
      "type": "string",
      "description": "The description value"
    },
    "destinationCalendar": {
      "type": "object",
      "description": "Destination Calendar",
      "properties": {
        "integration": {
          "type": "string",
          "description": "The integration type of the destination calendar. Refer to the /api/v2/calendars endpoint to retrieve the integration type of your connected calendars."
        },
        "externalId": {
          "type": "string",
          "description": "The external ID of the destination calendar. Refer to the /api/v2/calendars endpoint to retrieve the external IDs of your connected calendars."
        }
      },
      "required": [
        "integration",
        "externalId"
      ]
    },
    "disableCancelling": {
      "description": "Settings for disabling cancelling of this event type."
    },
    "disableGuests": {
      "type": "boolean",
      "description": "If true, person booking this event can't add guests via their emails."
    },
    "disableRescheduling": {
      "description": "Settings for disabling rescheduling of this event type. Can be always disabled or disabled when less than X minutes before the meeting."
    },
    "hidden": {
      "type": "boolean",
      "description": "The hidden value"
    },
    "hideCalendarEventDetails": {
      "type": "boolean",
      "description": "Hide Calendar Event Details"
    },
    "hideCalendarNotes": {
      "type": "boolean",
      "description": "Hide Calendar Notes"
    },
    "hideOrganizerEmail": {
      "type": "boolean",
      "description": "Boolean to Hide organizer's email address from the booking screen, email notifications, and calendar events"
    },
    "interfaceLanguage": {
      "type": "string",
      "description": "Set preferred language for the booking interface. Use empty string for visitor's browser language (default).",
      "enum": [
        "",
        "en",
        "ar",
        "az",
        "bg",
        "bn",
        "ca",
        "cs",
        "da",
        "de",
        "el",
        "es",
        "es-419",
        "eu",
        "et",
        "fi",
        "fr",
        "he",
        "hu",
        "it",
        "ja",
        "km",
        "ko",
        "nl",
        "no",
        "pl",
        "pt-BR",
        "pt",
        "ro",
        "ru",
        "sk-SK",
        "sr",
        "sv",
        "tr",
        "uk",
        "vi",
        "zh-CN",
        "zh-TW"
      ]
    },
    "lengthInMinutes": {
      "type": "number",
      "description": "Length In Minutes"
    },
    "lengthInMinutesOptions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "If you want that user can choose between different lengths of the event you can specify them here. Must include the provided `lengthInMinutes`."
    },
    "locations": {
      "type": "array",
      "description": "Locations where the event will take place. If not provided, cal video link will be used as the location. Note: Setting a location to a conferencing app does not install the app - the app must already be installed. Via API, only Google Meet (google-meet), Microsoft Teams (office365-video), and Zoom (zoom) can be installed. Cal Video (cal-video) is installed by default. All other conferencing apps must be connected via the Cal.com web app and are not available for Platform plan customers. You can only set an event type location to an app that has already been installed or connected."
    },
    "lockTimeZoneToggleOnBookingPage": {
      "type": "boolean",
      "description": "Lock Time Zone Toggle On Booking Page"
    },
    "minimumBookingNotice": {
      "type": "number",
      "description": "Minimum number of minutes before the event that a booking can be made."
    },
    "offsetStart": {
      "type": "number",
      "description": "Offset timeslots shown to bookers by a specified number of minutes"
    },
    "onlyShowFirstAvailableSlot": {
      "type": "boolean",
      "description": "This will limit your availability for this event type to one slot per day, scheduled at the earliest available time."
    },
    "recurrence": {
      "description": "Create a recurring event type."
    },
    "requiresBookerEmailVerification": {
      "type": "boolean",
      "description": "Requires Booker Email Verification"
    },
    "scheduleId": {
      "type": "number",
      "description": "If you want that this event has different schedule than user's default one you can specify it here."
    },
    "seats": {
      "description": "Create an event type with multiple seats."
    },
    "showOptimizedSlots": {
      "type": "boolean",
      "description": "Arrange time slots to optimize availability."
    },
    "slotInterval": {
      "type": "number",
      "description": "Number representing length of each slot when event is booked. By default it equal length of the event type.       If event length is 60 minutes then we would have slots 9AM, 10AM, 11AM etc. but if it was changed to 30 minutes then       we would have slots 9AM, 9:30AM, 10AM, 10:30AM etc. as the available times to book the 60 minute event."
    },
    "slug": {
      "type": "string",
      "description": "The slug value"
    },
    "successRedirectUrl": {
      "type": "string",
      "description": "A valid URL where the booker will redirect to, once the booking is completed successfully"
    },
    "title": {
      "type": "string",
      "description": "The title value"
    },
    "useDestinationCalendarEmail": {
      "type": "boolean",
      "description": "Use Destination Calendar Email"
    }
  },
  "required": [
    "PCID",
    "cal-api-version",
    "eventTypeId"
  ]
}

cal_event_types_type_webhooks_controller_create_event_type_webhook

Create a webhook Parameters:

Parameter	Type	Required	Default	Description
`eventTypeId`	number	Yes	—	Event Type Id
`active`	boolean	Yes	—	The active value
`payloadTemplate`	string	No	—	The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information
`secret`	string	No	—	The secret value
`subscriberUrl`	string	Yes	—	Subscriber Url
`triggers`	string[]	Yes	—	The triggers value
`version`	string	No	—	The version of the webhook

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "eventTypeId": {
      "type": "number",
      "description": "Event Type Id"
    },
    "active": {
      "type": "boolean",
      "description": "The active value"
    },
    "payloadTemplate": {
      "type": "string",
      "description": "The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information"
    },
    "secret": {
      "type": "string",
      "description": "The secret value"
    },
    "subscriberUrl": {
      "type": "string",
      "description": "Subscriber Url"
    },
    "triggers": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "BOOKING_CREATED",
          "BOOKING_PAYMENT_INITIATED",
          "BOOKING_PAID",
          "BOOKING_RESCHEDULED",
          "BOOKING_REQUESTED",
          "BOOKING_CANCELLED",
          "BOOKING_REJECTED",
          "BOOKING_NO_SHOW_UPDATED",
          "FORM_SUBMITTED",
          "MEETING_ENDED",
          "MEETING_STARTED",
          "RECORDING_READY",
          "INSTANT_MEETING",
          "RECORDING_TRANSCRIPTION_GENERATED",
          "OOO_CREATED",
          "AFTER_HOSTS_CAL_VIDEO_NO_SHOW",
          "AFTER_GUESTS_CAL_VIDEO_NO_SHOW",
          "FORM_SUBMITTED_NO_EVENT",
          "ROUTING_FORM_FALLBACK_HIT",
          "DELEGATION_CREDENTIAL_ERROR",
          "WRONG_ASSIGNMENT_REPORT"
        ]
      },
      "description": "The triggers value"
    },
    "version": {
      "type": "string",
      "description": "The version of the webhook",
      "enum": [
        "2021-10-20"
      ]
    }
  },
  "required": [
    "PCID",
    "eventTypeId",
    "active",
    "subscriberUrl",
    "triggers"
  ]
}

cal_event_types_type_webhooks_controller_delete_all_event_type_webhooks

Delete all webhooks Parameters:

Parameter	Type	Required	Default	Description
`eventTypeId`	number	Yes	—	Event Type Id

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "eventTypeId": {
      "type": "number",
      "description": "Event Type Id"
    }
  },
  "required": [
    "PCID",
    "eventTypeId"
  ]
}

cal_event_types_type_webhooks_controller_delete_event_type_webhook

Delete a webhook Parameters:

Parameter	Type	Required	Default	Description
`webhookId`	string	Yes	—	Webhook Id
`eventTypeId`	number	Yes	—	Event Type Id

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "webhookId": {
      "type": "string",
      "description": "Webhook Id"
    },
    "eventTypeId": {
      "type": "number",
      "description": "Event Type Id"
    }
  },
  "required": [
    "PCID",
    "webhookId",
    "eventTypeId"
  ]
}

cal_event_types_type_webhooks_controller_get_event_type_webhook

Get a webhook Parameters:

Parameter	Type	Required	Default	Description
`webhookId`	string	Yes	—	Webhook Id
`eventTypeId`	number	Yes	—	Event Type Id

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "webhookId": {
      "type": "string",
      "description": "Webhook Id"
    },
    "eventTypeId": {
      "type": "number",
      "description": "Event Type Id"
    }
  },
  "required": [
    "PCID",
    "webhookId",
    "eventTypeId"
  ]
}

cal_event_types_type_webhooks_controller_get_event_type_webhooks

Get all webhooks Parameters:

Parameter	Type	Required	Default	Description
`eventTypeId`	number	Yes	—	Event Type Id
`take`	number	No	—	Maximum number of items to return
`skip`	number	No	—	Number of items to skip

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "eventTypeId": {
      "type": "number",
      "description": "Event Type Id"
    },
    "take": {
      "type": "number",
      "description": "Maximum number of items to return"
    },
    "skip": {
      "type": "number",
      "description": "Number of items to skip"
    }
  },
  "required": [
    "PCID",
    "eventTypeId"
  ]
}

cal_event_types_type_webhooks_controller_update_event_type_webhook

Update a webhook Parameters:

Parameter	Type	Required	Default	Description
`webhookId`	string	Yes	—	Webhook Id
`eventTypeId`	number	Yes	—	Event Type Id
`active`	boolean	No	—	The active value
`payloadTemplate`	string	No	—	The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information
`secret`	string	No	—	The secret value
`subscriberUrl`	string	No	—	Subscriber Url
`triggers`	string[]	No	—	The triggers value
`version`	string	No	—	The version of the webhook

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "webhookId": {
      "type": "string",
      "description": "Webhook Id"
    },
    "eventTypeId": {
      "type": "number",
      "description": "Event Type Id"
    },
    "active": {
      "type": "boolean",
      "description": "The active value"
    },
    "payloadTemplate": {
      "type": "string",
      "description": "The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information"
    },
    "secret": {
      "type": "string",
      "description": "The secret value"
    },
    "subscriberUrl": {
      "type": "string",
      "description": "Subscriber Url"
    },
    "triggers": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "BOOKING_CREATED",
          "BOOKING_PAYMENT_INITIATED",
          "BOOKING_PAID",
          "BOOKING_RESCHEDULED",
          "BOOKING_REQUESTED",
          "BOOKING_CANCELLED",
          "BOOKING_REJECTED",
          "BOOKING_NO_SHOW_UPDATED",
          "FORM_SUBMITTED",
          "MEETING_ENDED",
          "MEETING_STARTED",
          "RECORDING_READY",
          "INSTANT_MEETING",
          "RECORDING_TRANSCRIPTION_GENERATED",
          "OOO_CREATED",
          "AFTER_HOSTS_CAL_VIDEO_NO_SHOW",
          "AFTER_GUESTS_CAL_VIDEO_NO_SHOW",
          "FORM_SUBMITTED_NO_EVENT",
          "ROUTING_FORM_FALLBACK_HIT",
          "DELEGATION_CREDENTIAL_ERROR",
          "WRONG_ASSIGNMENT_REPORT"
        ]
      },
      "description": "The triggers value"
    },
    "version": {
      "type": "string",
      "description": "The version of the webhook",
      "enum": [
        "2021-10-20"
      ]
    }
  },
  "required": [
    "PCID",
    "webhookId",
    "eventTypeId"
  ]
}

​Tools

​cal_event_types_controller_2024_06_14_create_event_type

​cal_event_types_controller_2024_06_14_delete_event_type

​cal_event_types_controller_2024_06_14_get_event_type_by_id

​cal_event_types_controller_2024_06_14_get_event_types

​cal_event_types_controller_2024_06_14_update_event_type

​cal_event_types_type_webhooks_controller_create_event_type_webhook

​cal_event_types_type_webhooks_controller_delete_all_event_type_webhooks

​cal_event_types_type_webhooks_controller_delete_event_type_webhook

​cal_event_types_type_webhooks_controller_get_event_type_webhook

​cal_event_types_type_webhooks_controller_get_event_type_webhooks

​cal_event_types_type_webhooks_controller_update_event_type_webhook

Tools

cal_event_types_controller_2024_06_14_create_event_type

cal_event_types_controller_2024_06_14_delete_event_type

cal_event_types_controller_2024_06_14_get_event_type_by_id

cal_event_types_controller_2024_06_14_get_event_types

cal_event_types_controller_2024_06_14_update_event_type

cal_event_types_type_webhooks_controller_create_event_type_webhook

cal_event_types_type_webhooks_controller_delete_all_event_type_webhooks

cal_event_types_type_webhooks_controller_delete_event_type_webhook

cal_event_types_type_webhooks_controller_get_event_type_webhook

cal_event_types_type_webhooks_controller_get_event_type_webhooks

cal_event_types_type_webhooks_controller_update_event_type_webhook