Create a team event type
curl --request POST \
--url https://api.cal.com/v2/teams/{teamId}/event-types \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'cal-api-version: <cal-api-version>' \
--data '
{
"lengthInMinutes": 60,
"title": "Learn the secrets of masterchief!",
"slug": "learn-the-secrets-of-masterchief",
"schedulingType": "collective",
"calendarInvites": {
"host": {
"mode": "custom",
"template": "Meeting with {ATTENDEE}"
}
},
"lengthInMinutesOptions": [
15,
30,
60
],
"description": "Discover the culinary wonders of the Argentina by making the best flan ever!",
"slotInterval": 123,
"minimumBookingNotice": 1,
"beforeEventBuffer": 123,
"afterEventBuffer": 123,
"scheduleId": 123,
"bookingLimitsCount": {
"day": 1,
"week": 2,
"month": 3,
"year": 4
},
"bookerActiveBookingsLimit": {
"maximumActiveBookings": 3,
"offerReschedule": true,
"disabled": false
},
"onlyShowFirstAvailableSlot": true,
"bookingLimitsDuration": {
"day": 60,
"week": 120,
"month": 180,
"year": 240,
"disabled": false
},
"bookingWindow": {
"value": 5,
"rolling": true,
"disabled": false
},
"offsetStart": 1,
"confirmationPolicy": {
"type": "always",
"blockUnconfirmedBookingsInBooker": true,
"disabled": false
},
"recurrence": {
"interval": 1,
"occurrences": 10,
"disabled": false
},
"requiresBookerEmailVerification": true,
"skipAttendeeEmailDeliverabilityCheck": true,
"emailSettings": {
"disableEmailsToAttendees": true,
"disableEmailsToHosts": true,
"disableProposalEmailsToHosts": true
},
"hideCalendarNotes": true,
"lockTimeZoneToggleOnBookingPage": true,
"seats": {
"seatsPerTimeSlot": 4,
"showAttendeeInfo": true,
"showAvailabilityCount": true,
"disabled": false
},
"customName": "{Link title} between {Organiser} and {Scheduler}",
"useDestinationCalendarEmail": true,
"hideCalendarEventDetails": true,
"successRedirectUrl": "https://masterchief.com/argentina/flan/video/9129412",
"hideOrganizerEmail": true,
"calVideoSettings": {
"disableRecordingForOrganizer": false,
"disableRecordingForGuests": false,
"redirectUrlOnExit": "<string>",
"enableAutomaticRecordingForOrganizer": false,
"enableAutomaticTranscription": false,
"disableTranscriptionForGuests": false,
"disableTranscriptionForOrganizer": false,
"hideTranscriptionForGuests": false,
"hideTranscriptionForOrganizer": false,
"sendTranscriptionEmails": true,
"disableAttendeeRecordingDownloadEmail": false
},
"hidden": true,
"bookingRequiresAuthentication": false,
"disableCancelling": {
"disabled": true
},
"disableRescheduling": {
"disabled": false,
"minutesBefore": 60
},
"weekStart": "Monday",
"allowReschedulingPastBookings": false,
"allowReschedulingCancelledBookings": false,
"showOptimizedSlots": false,
"useIsolatedAvailability": false,
"privateNoteEnabled": false,
"privateNoteMode": "duplicate_event",
"privateNoteTemplate": "Meeting with {Attendee name} for {Link title}",
"hosts": [
{
"userId": 123,
"mandatory": false,
"priority": "medium",
"weight": 100
}
],
"assignAllTeamMembers": true,
"locations": [
{
"type": "address",
"address": "123 Example St, City, Country",
"public": true
}
],
"rescheduleWithSameRoundRobinHost": true,
"allowRRHostChoiceOnReschedule": true,
"isRRWeightsEnabled": true,
"bookingFields": [
{
"field": "name",
"variant": "fullName",
"slug": "name",
"label": "<string>",
"placeholder": "<string>",
"disableOnPrefill": true
}
],
"crm": {
"hubspot": {
"enabled": true,
"ignoreGuests": true,
"skipContactCreation": true
},
"salesforce": {
"enabled": true,
"ignoreGuests": true,
"skipContactCreation": true
}
}
}
'import requests
url = "https://api.cal.com/v2/teams/{teamId}/event-types"
payload = {
"lengthInMinutes": 60,
"title": "Learn the secrets of masterchief!",
"slug": "learn-the-secrets-of-masterchief",
"schedulingType": "collective",
"calendarInvites": { "host": {
"mode": "custom",
"template": "Meeting with {ATTENDEE}"
} },
"lengthInMinutesOptions": [15, 30, 60],
"description": "Discover the culinary wonders of the Argentina by making the best flan ever!",
"slotInterval": 123,
"minimumBookingNotice": 1,
"beforeEventBuffer": 123,
"afterEventBuffer": 123,
"scheduleId": 123,
"bookingLimitsCount": {
"day": 1,
"week": 2,
"month": 3,
"year": 4
},
"bookerActiveBookingsLimit": {
"maximumActiveBookings": 3,
"offerReschedule": True,
"disabled": False
},
"onlyShowFirstAvailableSlot": True,
"bookingLimitsDuration": {
"day": 60,
"week": 120,
"month": 180,
"year": 240,
"disabled": False
},
"bookingWindow": {
"value": 5,
"rolling": True,
"disabled": False
},
"offsetStart": 1,
"confirmationPolicy": {
"type": "always",
"blockUnconfirmedBookingsInBooker": True,
"disabled": False
},
"recurrence": {
"interval": 1,
"occurrences": 10,
"disabled": False
},
"requiresBookerEmailVerification": True,
"skipAttendeeEmailDeliverabilityCheck": True,
"emailSettings": {
"disableEmailsToAttendees": True,
"disableEmailsToHosts": True,
"disableProposalEmailsToHosts": True
},
"hideCalendarNotes": True,
"lockTimeZoneToggleOnBookingPage": True,
"seats": {
"seatsPerTimeSlot": 4,
"showAttendeeInfo": True,
"showAvailabilityCount": True,
"disabled": False
},
"customName": "{Link title} between {Organiser} and {Scheduler}",
"useDestinationCalendarEmail": True,
"hideCalendarEventDetails": True,
"successRedirectUrl": "https://masterchief.com/argentina/flan/video/9129412",
"hideOrganizerEmail": True,
"calVideoSettings": {
"disableRecordingForOrganizer": False,
"disableRecordingForGuests": False,
"redirectUrlOnExit": "<string>",
"enableAutomaticRecordingForOrganizer": False,
"enableAutomaticTranscription": False,
"disableTranscriptionForGuests": False,
"disableTranscriptionForOrganizer": False,
"hideTranscriptionForGuests": False,
"hideTranscriptionForOrganizer": False,
"sendTranscriptionEmails": True,
"disableAttendeeRecordingDownloadEmail": False
},
"hidden": True,
"bookingRequiresAuthentication": False,
"disableCancelling": { "disabled": True },
"disableRescheduling": {
"disabled": False,
"minutesBefore": 60
},
"weekStart": "Monday",
"allowReschedulingPastBookings": False,
"allowReschedulingCancelledBookings": False,
"showOptimizedSlots": False,
"useIsolatedAvailability": False,
"privateNoteEnabled": False,
"privateNoteMode": "duplicate_event",
"privateNoteTemplate": "Meeting with {Attendee name} for {Link title}",
"hosts": [
{
"userId": 123,
"mandatory": False,
"priority": "medium",
"weight": 100
}
],
"assignAllTeamMembers": True,
"locations": [
{
"type": "address",
"address": "123 Example St, City, Country",
"public": True
}
],
"rescheduleWithSameRoundRobinHost": True,
"allowRRHostChoiceOnReschedule": True,
"isRRWeightsEnabled": True,
"bookingFields": [
{
"field": "name",
"variant": "fullName",
"slug": "name",
"label": "<string>",
"placeholder": "<string>",
"disableOnPrefill": True
}
],
"crm": {
"hubspot": {
"enabled": True,
"ignoreGuests": True,
"skipContactCreation": True
},
"salesforce": {
"enabled": True,
"ignoreGuests": True,
"skipContactCreation": True
}
}
}
headers = {
"cal-api-version": "<cal-api-version>",
"Authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'cal-api-version': '<cal-api-version>',
Authorization: '<authorization>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
lengthInMinutes: 60,
title: 'Learn the secrets of masterchief!',
slug: 'learn-the-secrets-of-masterchief',
schedulingType: 'collective',
calendarInvites: {host: {mode: 'custom', template: 'Meeting with {ATTENDEE}'}},
lengthInMinutesOptions: [15, 30, 60],
description: 'Discover the culinary wonders of the Argentina by making the best flan ever!',
slotInterval: 123,
minimumBookingNotice: 1,
beforeEventBuffer: 123,
afterEventBuffer: 123,
scheduleId: 123,
bookingLimitsCount: {day: 1, week: 2, month: 3, year: 4},
bookerActiveBookingsLimit: {maximumActiveBookings: 3, offerReschedule: true, disabled: false},
onlyShowFirstAvailableSlot: true,
bookingLimitsDuration: {day: 60, week: 120, month: 180, year: 240, disabled: false},
bookingWindow: {value: 5, rolling: true, disabled: false},
offsetStart: 1,
confirmationPolicy: {type: 'always', blockUnconfirmedBookingsInBooker: true, disabled: false},
recurrence: {interval: 1, occurrences: 10, disabled: false},
requiresBookerEmailVerification: true,
skipAttendeeEmailDeliverabilityCheck: true,
emailSettings: {
disableEmailsToAttendees: true,
disableEmailsToHosts: true,
disableProposalEmailsToHosts: true
},
hideCalendarNotes: true,
lockTimeZoneToggleOnBookingPage: true,
seats: {
seatsPerTimeSlot: 4,
showAttendeeInfo: true,
showAvailabilityCount: true,
disabled: false
},
customName: '{Link title} between {Organiser} and {Scheduler}',
useDestinationCalendarEmail: true,
hideCalendarEventDetails: true,
successRedirectUrl: 'https://masterchief.com/argentina/flan/video/9129412',
hideOrganizerEmail: true,
calVideoSettings: {
disableRecordingForOrganizer: false,
disableRecordingForGuests: false,
redirectUrlOnExit: '<string>',
enableAutomaticRecordingForOrganizer: false,
enableAutomaticTranscription: false,
disableTranscriptionForGuests: false,
disableTranscriptionForOrganizer: false,
hideTranscriptionForGuests: false,
hideTranscriptionForOrganizer: false,
sendTranscriptionEmails: true,
disableAttendeeRecordingDownloadEmail: false
},
hidden: true,
bookingRequiresAuthentication: false,
disableCancelling: {disabled: true},
disableRescheduling: {disabled: false, minutesBefore: 60},
weekStart: 'Monday',
allowReschedulingPastBookings: false,
allowReschedulingCancelledBookings: false,
showOptimizedSlots: false,
useIsolatedAvailability: false,
privateNoteEnabled: false,
privateNoteMode: 'duplicate_event',
privateNoteTemplate: 'Meeting with {Attendee name} for {Link title}',
hosts: [{userId: 123, mandatory: false, priority: 'medium', weight: 100}],
assignAllTeamMembers: true,
locations: [{type: 'address', address: '123 Example St, City, Country', public: true}],
rescheduleWithSameRoundRobinHost: true,
allowRRHostChoiceOnReschedule: true,
isRRWeightsEnabled: true,
bookingFields: [
{
field: 'name',
variant: 'fullName',
slug: 'name',
label: '<string>',
placeholder: '<string>',
disableOnPrefill: true
}
],
crm: {
hubspot: {enabled: true, ignoreGuests: true, skipContactCreation: true},
salesforce: {enabled: true, ignoreGuests: true, skipContactCreation: true}
}
})
};
fetch('https://api.cal.com/v2/teams/{teamId}/event-types', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cal.com/v2/teams/{teamId}/event-types",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'lengthInMinutes' => 60,
'title' => 'Learn the secrets of masterchief!',
'slug' => 'learn-the-secrets-of-masterchief',
'schedulingType' => 'collective',
'calendarInvites' => [
'host' => [
'mode' => 'custom',
'template' => 'Meeting with {ATTENDEE}'
]
],
'lengthInMinutesOptions' => [
15,
30,
60
],
'description' => 'Discover the culinary wonders of the Argentina by making the best flan ever!',
'slotInterval' => 123,
'minimumBookingNotice' => 1,
'beforeEventBuffer' => 123,
'afterEventBuffer' => 123,
'scheduleId' => 123,
'bookingLimitsCount' => [
'day' => 1,
'week' => 2,
'month' => 3,
'year' => 4
],
'bookerActiveBookingsLimit' => [
'maximumActiveBookings' => 3,
'offerReschedule' => true,
'disabled' => false
],
'onlyShowFirstAvailableSlot' => true,
'bookingLimitsDuration' => [
'day' => 60,
'week' => 120,
'month' => 180,
'year' => 240,
'disabled' => false
],
'bookingWindow' => [
'value' => 5,
'rolling' => true,
'disabled' => false
],
'offsetStart' => 1,
'confirmationPolicy' => [
'type' => 'always',
'blockUnconfirmedBookingsInBooker' => true,
'disabled' => false
],
'recurrence' => [
'interval' => 1,
'occurrences' => 10,
'disabled' => false
],
'requiresBookerEmailVerification' => true,
'skipAttendeeEmailDeliverabilityCheck' => true,
'emailSettings' => [
'disableEmailsToAttendees' => true,
'disableEmailsToHosts' => true,
'disableProposalEmailsToHosts' => true
],
'hideCalendarNotes' => true,
'lockTimeZoneToggleOnBookingPage' => true,
'seats' => [
'seatsPerTimeSlot' => 4,
'showAttendeeInfo' => true,
'showAvailabilityCount' => true,
'disabled' => false
],
'customName' => '{Link title} between {Organiser} and {Scheduler}',
'useDestinationCalendarEmail' => true,
'hideCalendarEventDetails' => true,
'successRedirectUrl' => 'https://masterchief.com/argentina/flan/video/9129412',
'hideOrganizerEmail' => true,
'calVideoSettings' => [
'disableRecordingForOrganizer' => false,
'disableRecordingForGuests' => false,
'redirectUrlOnExit' => '<string>',
'enableAutomaticRecordingForOrganizer' => false,
'enableAutomaticTranscription' => false,
'disableTranscriptionForGuests' => false,
'disableTranscriptionForOrganizer' => false,
'hideTranscriptionForGuests' => false,
'hideTranscriptionForOrganizer' => false,
'sendTranscriptionEmails' => true,
'disableAttendeeRecordingDownloadEmail' => false
],
'hidden' => true,
'bookingRequiresAuthentication' => false,
'disableCancelling' => [
'disabled' => true
],
'disableRescheduling' => [
'disabled' => false,
'minutesBefore' => 60
],
'weekStart' => 'Monday',
'allowReschedulingPastBookings' => false,
'allowReschedulingCancelledBookings' => false,
'showOptimizedSlots' => false,
'useIsolatedAvailability' => false,
'privateNoteEnabled' => false,
'privateNoteMode' => 'duplicate_event',
'privateNoteTemplate' => 'Meeting with {Attendee name} for {Link title}',
'hosts' => [
[
'userId' => 123,
'mandatory' => false,
'priority' => 'medium',
'weight' => 100
]
],
'assignAllTeamMembers' => true,
'locations' => [
[
'type' => 'address',
'address' => '123 Example St, City, Country',
'public' => true
]
],
'rescheduleWithSameRoundRobinHost' => true,
'allowRRHostChoiceOnReschedule' => true,
'isRRWeightsEnabled' => true,
'bookingFields' => [
[
'field' => 'name',
'variant' => 'fullName',
'slug' => 'name',
'label' => '<string>',
'placeholder' => '<string>',
'disableOnPrefill' => true
]
],
'crm' => [
'hubspot' => [
'enabled' => true,
'ignoreGuests' => true,
'skipContactCreation' => true
],
'salesforce' => [
'enabled' => true,
'ignoreGuests' => true,
'skipContactCreation' => true
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json",
"cal-api-version: <cal-api-version>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.cal.com/v2/teams/{teamId}/event-types"
payload := strings.NewReader("{\n \"lengthInMinutes\": 60,\n \"title\": \"Learn the secrets of masterchief!\",\n \"slug\": \"learn-the-secrets-of-masterchief\",\n \"schedulingType\": \"collective\",\n \"calendarInvites\": {\n \"host\": {\n \"mode\": \"custom\",\n \"template\": \"Meeting with {ATTENDEE}\"\n }\n },\n \"lengthInMinutesOptions\": [\n 15,\n 30,\n 60\n ],\n \"description\": \"Discover the culinary wonders of the Argentina by making the best flan ever!\",\n \"slotInterval\": 123,\n \"minimumBookingNotice\": 1,\n \"beforeEventBuffer\": 123,\n \"afterEventBuffer\": 123,\n \"scheduleId\": 123,\n \"bookingLimitsCount\": {\n \"day\": 1,\n \"week\": 2,\n \"month\": 3,\n \"year\": 4\n },\n \"bookerActiveBookingsLimit\": {\n \"maximumActiveBookings\": 3,\n \"offerReschedule\": true,\n \"disabled\": false\n },\n \"onlyShowFirstAvailableSlot\": true,\n \"bookingLimitsDuration\": {\n \"day\": 60,\n \"week\": 120,\n \"month\": 180,\n \"year\": 240,\n \"disabled\": false\n },\n \"bookingWindow\": {\n \"value\": 5,\n \"rolling\": true,\n \"disabled\": false\n },\n \"offsetStart\": 1,\n \"confirmationPolicy\": {\n \"type\": \"always\",\n \"blockUnconfirmedBookingsInBooker\": true,\n \"disabled\": false\n },\n \"recurrence\": {\n \"interval\": 1,\n \"occurrences\": 10,\n \"disabled\": false\n },\n \"requiresBookerEmailVerification\": true,\n \"skipAttendeeEmailDeliverabilityCheck\": true,\n \"emailSettings\": {\n \"disableEmailsToAttendees\": true,\n \"disableEmailsToHosts\": true,\n \"disableProposalEmailsToHosts\": true\n },\n \"hideCalendarNotes\": true,\n \"lockTimeZoneToggleOnBookingPage\": true,\n \"seats\": {\n \"seatsPerTimeSlot\": 4,\n \"showAttendeeInfo\": true,\n \"showAvailabilityCount\": true,\n \"disabled\": false\n },\n \"customName\": \"{Link title} between {Organiser} and {Scheduler}\",\n \"useDestinationCalendarEmail\": true,\n \"hideCalendarEventDetails\": true,\n \"successRedirectUrl\": \"https://masterchief.com/argentina/flan/video/9129412\",\n \"hideOrganizerEmail\": true,\n \"calVideoSettings\": {\n \"disableRecordingForOrganizer\": false,\n \"disableRecordingForGuests\": false,\n \"redirectUrlOnExit\": \"<string>\",\n \"enableAutomaticRecordingForOrganizer\": false,\n \"enableAutomaticTranscription\": false,\n \"disableTranscriptionForGuests\": false,\n \"disableTranscriptionForOrganizer\": false,\n \"hideTranscriptionForGuests\": false,\n \"hideTranscriptionForOrganizer\": false,\n \"sendTranscriptionEmails\": true,\n \"disableAttendeeRecordingDownloadEmail\": false\n },\n \"hidden\": true,\n \"bookingRequiresAuthentication\": false,\n \"disableCancelling\": {\n \"disabled\": true\n },\n \"disableRescheduling\": {\n \"disabled\": false,\n \"minutesBefore\": 60\n },\n \"weekStart\": \"Monday\",\n \"allowReschedulingPastBookings\": false,\n \"allowReschedulingCancelledBookings\": false,\n \"showOptimizedSlots\": false,\n \"useIsolatedAvailability\": false,\n \"privateNoteEnabled\": false,\n \"privateNoteMode\": \"duplicate_event\",\n \"privateNoteTemplate\": \"Meeting with {Attendee name} for {Link title}\",\n \"hosts\": [\n {\n \"userId\": 123,\n \"mandatory\": false,\n \"priority\": \"medium\",\n \"weight\": 100\n }\n ],\n \"assignAllTeamMembers\": true,\n \"locations\": [\n {\n \"type\": \"address\",\n \"address\": \"123 Example St, City, Country\",\n \"public\": true\n }\n ],\n \"rescheduleWithSameRoundRobinHost\": true,\n \"allowRRHostChoiceOnReschedule\": true,\n \"isRRWeightsEnabled\": true,\n \"bookingFields\": [\n {\n \"field\": \"name\",\n \"variant\": \"fullName\",\n \"slug\": \"name\",\n \"label\": \"<string>\",\n \"placeholder\": \"<string>\",\n \"disableOnPrefill\": true\n }\n ],\n \"crm\": {\n \"hubspot\": {\n \"enabled\": true,\n \"ignoreGuests\": true,\n \"skipContactCreation\": true\n },\n \"salesforce\": {\n \"enabled\": true,\n \"ignoreGuests\": true,\n \"skipContactCreation\": true\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("cal-api-version", "<cal-api-version>")
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.cal.com/v2/teams/{teamId}/event-types")
.header("cal-api-version", "<cal-api-version>")
.header("Authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"lengthInMinutes\": 60,\n \"title\": \"Learn the secrets of masterchief!\",\n \"slug\": \"learn-the-secrets-of-masterchief\",\n \"schedulingType\": \"collective\",\n \"calendarInvites\": {\n \"host\": {\n \"mode\": \"custom\",\n \"template\": \"Meeting with {ATTENDEE}\"\n }\n },\n \"lengthInMinutesOptions\": [\n 15,\n 30,\n 60\n ],\n \"description\": \"Discover the culinary wonders of the Argentina by making the best flan ever!\",\n \"slotInterval\": 123,\n \"minimumBookingNotice\": 1,\n \"beforeEventBuffer\": 123,\n \"afterEventBuffer\": 123,\n \"scheduleId\": 123,\n \"bookingLimitsCount\": {\n \"day\": 1,\n \"week\": 2,\n \"month\": 3,\n \"year\": 4\n },\n \"bookerActiveBookingsLimit\": {\n \"maximumActiveBookings\": 3,\n \"offerReschedule\": true,\n \"disabled\": false\n },\n \"onlyShowFirstAvailableSlot\": true,\n \"bookingLimitsDuration\": {\n \"day\": 60,\n \"week\": 120,\n \"month\": 180,\n \"year\": 240,\n \"disabled\": false\n },\n \"bookingWindow\": {\n \"value\": 5,\n \"rolling\": true,\n \"disabled\": false\n },\n \"offsetStart\": 1,\n \"confirmationPolicy\": {\n \"type\": \"always\",\n \"blockUnconfirmedBookingsInBooker\": true,\n \"disabled\": false\n },\n \"recurrence\": {\n \"interval\": 1,\n \"occurrences\": 10,\n \"disabled\": false\n },\n \"requiresBookerEmailVerification\": true,\n \"skipAttendeeEmailDeliverabilityCheck\": true,\n \"emailSettings\": {\n \"disableEmailsToAttendees\": true,\n \"disableEmailsToHosts\": true,\n \"disableProposalEmailsToHosts\": true\n },\n \"hideCalendarNotes\": true,\n \"lockTimeZoneToggleOnBookingPage\": true,\n \"seats\": {\n \"seatsPerTimeSlot\": 4,\n \"showAttendeeInfo\": true,\n \"showAvailabilityCount\": true,\n \"disabled\": false\n },\n \"customName\": \"{Link title} between {Organiser} and {Scheduler}\",\n \"useDestinationCalendarEmail\": true,\n \"hideCalendarEventDetails\": true,\n \"successRedirectUrl\": \"https://masterchief.com/argentina/flan/video/9129412\",\n \"hideOrganizerEmail\": true,\n \"calVideoSettings\": {\n \"disableRecordingForOrganizer\": false,\n \"disableRecordingForGuests\": false,\n \"redirectUrlOnExit\": \"<string>\",\n \"enableAutomaticRecordingForOrganizer\": false,\n \"enableAutomaticTranscription\": false,\n \"disableTranscriptionForGuests\": false,\n \"disableTranscriptionForOrganizer\": false,\n \"hideTranscriptionForGuests\": false,\n \"hideTranscriptionForOrganizer\": false,\n \"sendTranscriptionEmails\": true,\n \"disableAttendeeRecordingDownloadEmail\": false\n },\n \"hidden\": true,\n \"bookingRequiresAuthentication\": false,\n \"disableCancelling\": {\n \"disabled\": true\n },\n \"disableRescheduling\": {\n \"disabled\": false,\n \"minutesBefore\": 60\n },\n \"weekStart\": \"Monday\",\n \"allowReschedulingPastBookings\": false,\n \"allowReschedulingCancelledBookings\": false,\n \"showOptimizedSlots\": false,\n \"useIsolatedAvailability\": false,\n \"privateNoteEnabled\": false,\n \"privateNoteMode\": \"duplicate_event\",\n \"privateNoteTemplate\": \"Meeting with {Attendee name} for {Link title}\",\n \"hosts\": [\n {\n \"userId\": 123,\n \"mandatory\": false,\n \"priority\": \"medium\",\n \"weight\": 100\n }\n ],\n \"assignAllTeamMembers\": true,\n \"locations\": [\n {\n \"type\": \"address\",\n \"address\": \"123 Example St, City, Country\",\n \"public\": true\n }\n ],\n \"rescheduleWithSameRoundRobinHost\": true,\n \"allowRRHostChoiceOnReschedule\": true,\n \"isRRWeightsEnabled\": true,\n \"bookingFields\": [\n {\n \"field\": \"name\",\n \"variant\": \"fullName\",\n \"slug\": \"name\",\n \"label\": \"<string>\",\n \"placeholder\": \"<string>\",\n \"disableOnPrefill\": true\n }\n ],\n \"crm\": {\n \"hubspot\": {\n \"enabled\": true,\n \"ignoreGuests\": true,\n \"skipContactCreation\": true\n },\n \"salesforce\": {\n \"enabled\": true,\n \"ignoreGuests\": true,\n \"skipContactCreation\": true\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cal.com/v2/teams/{teamId}/event-types")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["cal-api-version"] = '<cal-api-version>'
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"lengthInMinutes\": 60,\n \"title\": \"Learn the secrets of masterchief!\",\n \"slug\": \"learn-the-secrets-of-masterchief\",\n \"schedulingType\": \"collective\",\n \"calendarInvites\": {\n \"host\": {\n \"mode\": \"custom\",\n \"template\": \"Meeting with {ATTENDEE}\"\n }\n },\n \"lengthInMinutesOptions\": [\n 15,\n 30,\n 60\n ],\n \"description\": \"Discover the culinary wonders of the Argentina by making the best flan ever!\",\n \"slotInterval\": 123,\n \"minimumBookingNotice\": 1,\n \"beforeEventBuffer\": 123,\n \"afterEventBuffer\": 123,\n \"scheduleId\": 123,\n \"bookingLimitsCount\": {\n \"day\": 1,\n \"week\": 2,\n \"month\": 3,\n \"year\": 4\n },\n \"bookerActiveBookingsLimit\": {\n \"maximumActiveBookings\": 3,\n \"offerReschedule\": true,\n \"disabled\": false\n },\n \"onlyShowFirstAvailableSlot\": true,\n \"bookingLimitsDuration\": {\n \"day\": 60,\n \"week\": 120,\n \"month\": 180,\n \"year\": 240,\n \"disabled\": false\n },\n \"bookingWindow\": {\n \"value\": 5,\n \"rolling\": true,\n \"disabled\": false\n },\n \"offsetStart\": 1,\n \"confirmationPolicy\": {\n \"type\": \"always\",\n \"blockUnconfirmedBookingsInBooker\": true,\n \"disabled\": false\n },\n \"recurrence\": {\n \"interval\": 1,\n \"occurrences\": 10,\n \"disabled\": false\n },\n \"requiresBookerEmailVerification\": true,\n \"skipAttendeeEmailDeliverabilityCheck\": true,\n \"emailSettings\": {\n \"disableEmailsToAttendees\": true,\n \"disableEmailsToHosts\": true,\n \"disableProposalEmailsToHosts\": true\n },\n \"hideCalendarNotes\": true,\n \"lockTimeZoneToggleOnBookingPage\": true,\n \"seats\": {\n \"seatsPerTimeSlot\": 4,\n \"showAttendeeInfo\": true,\n \"showAvailabilityCount\": true,\n \"disabled\": false\n },\n \"customName\": \"{Link title} between {Organiser} and {Scheduler}\",\n \"useDestinationCalendarEmail\": true,\n \"hideCalendarEventDetails\": true,\n \"successRedirectUrl\": \"https://masterchief.com/argentina/flan/video/9129412\",\n \"hideOrganizerEmail\": true,\n \"calVideoSettings\": {\n \"disableRecordingForOrganizer\": false,\n \"disableRecordingForGuests\": false,\n \"redirectUrlOnExit\": \"<string>\",\n \"enableAutomaticRecordingForOrganizer\": false,\n \"enableAutomaticTranscription\": false,\n \"disableTranscriptionForGuests\": false,\n \"disableTranscriptionForOrganizer\": false,\n \"hideTranscriptionForGuests\": false,\n \"hideTranscriptionForOrganizer\": false,\n \"sendTranscriptionEmails\": true,\n \"disableAttendeeRecordingDownloadEmail\": false\n },\n \"hidden\": true,\n \"bookingRequiresAuthentication\": false,\n \"disableCancelling\": {\n \"disabled\": true\n },\n \"disableRescheduling\": {\n \"disabled\": false,\n \"minutesBefore\": 60\n },\n \"weekStart\": \"Monday\",\n \"allowReschedulingPastBookings\": false,\n \"allowReschedulingCancelledBookings\": false,\n \"showOptimizedSlots\": false,\n \"useIsolatedAvailability\": false,\n \"privateNoteEnabled\": false,\n \"privateNoteMode\": \"duplicate_event\",\n \"privateNoteTemplate\": \"Meeting with {Attendee name} for {Link title}\",\n \"hosts\": [\n {\n \"userId\": 123,\n \"mandatory\": false,\n \"priority\": \"medium\",\n \"weight\": 100\n }\n ],\n \"assignAllTeamMembers\": true,\n \"locations\": [\n {\n \"type\": \"address\",\n \"address\": \"123 Example St, City, Country\",\n \"public\": true\n }\n ],\n \"rescheduleWithSameRoundRobinHost\": true,\n \"allowRRHostChoiceOnReschedule\": true,\n \"isRRWeightsEnabled\": true,\n \"bookingFields\": [\n {\n \"field\": \"name\",\n \"variant\": \"fullName\",\n \"slug\": \"name\",\n \"label\": \"<string>\",\n \"placeholder\": \"<string>\",\n \"disableOnPrefill\": true\n }\n ],\n \"crm\": {\n \"hubspot\": {\n \"enabled\": true,\n \"ignoreGuests\": true,\n \"skipContactCreation\": true\n },\n \"salesforce\": {\n \"enabled\": true,\n \"ignoreGuests\": true,\n \"skipContactCreation\": true\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"id": 1,
"lengthInMinutes": 60,
"title": "Learn the secrets of masterchief!",
"slug": "learn-the-secrets-of-masterchief",
"description": "Discover the culinary wonders of Argentina by making the best flan ever!",
"locations": [
{
"type": "address",
"address": "123 Example St, City, Country",
"public": true
}
],
"disableGuests": true,
"recurrence": {
"interval": 1,
"occurrences": 10,
"frequency": "yearly",
"disabled": false
},
"metadata": {},
"price": 123,
"currency": "<string>",
"lockTimeZoneToggleOnBookingPage": true,
"forwardParamsSuccessRedirect": true,
"successRedirectUrl": "<string>",
"isInstantEvent": true,
"scheduleId": 123,
"hidden": true,
"bookingRequiresAuthentication": true,
"teamId": 123,
"bookingUrl": "https://cal.com/team/acme/30min",
"hosts": [
{
"userId": 123,
"name": "John Doe",
"username": "john-doe",
"mandatory": false,
"priority": "medium",
"weight": 100,
"userUuid": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
"avatarUrl": "https://cal.com/api/avatar/d95949bc-ccb1-400f-acf6-045c51a16856.png"
}
],
"schedulingType": "roundRobin",
"team": {
"id": 123,
"slug": "<string>",
"bannerUrl": "<string>",
"name": "<string>",
"logoUrl": "<string>",
"weekStart": "<string>",
"brandColor": "<string>",
"darkBrandColor": "<string>",
"theme": "<string>"
},
"bookingFields": [
{
"field": "name",
"slug": "name",
"variant": "fullName",
"disableOnPrefill": true,
"label": "<string>",
"placeholder": "<string>"
}
],
"crm": {
"hubspot": {
"enabled": true,
"ignoreGuests": true,
"skipContactCreation": true
},
"salesforce": {
"enabled": true,
"ignoreGuests": true,
"skipContactCreation": true
}
},
"lengthInMinutesOptions": [
15,
30,
60
],
"slotInterval": 60,
"minimumBookingNotice": 0,
"beforeEventBuffer": 0,
"afterEventBuffer": 0,
"seatsPerTimeSlot": 123,
"seatsShowAvailabilityCount": true,
"bookingLimitsCount": {
"day": 1,
"week": 2,
"month": 3,
"year": 4
},
"bookerActiveBookingsLimit": {
"maximumActiveBookings": 3,
"offerReschedule": true
},
"onlyShowFirstAvailableSlot": true,
"bookingLimitsDuration": {
"day": 60,
"week": 120,
"month": 180,
"year": 240,
"disabled": false
},
"bookingWindow": [
{
"type": "businessDays",
"value": 5,
"rolling": true,
"disabled": false
}
],
"bookerLayouts": {
"defaultLayout": "month",
"enabledLayouts": [
"month"
]
},
"confirmationPolicy": {
"type": "always",
"blockUnconfirmedBookingsInBooker": true,
"noticeThreshold": {
"unit": "minutes",
"count": 30
},
"disabled": false
},
"bookingProposalCount": 123,
"requiresBookerEmailVerification": true,
"skipAttendeeEmailDeliverabilityCheck": true,
"emailSettings": {
"disableEmailsToAttendees": true,
"disableEmailsToHosts": true,
"disableProposalEmailsToHosts": true
},
"hideCalendarNotes": true,
"color": {
"lightThemeHex": "#292929",
"darkThemeHex": "#fafafa"
},
"seats": {
"seatsPerTimeSlot": 4,
"showAttendeeInfo": true,
"showAvailabilityCount": true,
"disabled": false
},
"offsetStart": 123,
"customName": "<string>",
"destinationCalendar": {
"integration": "<string>",
"externalId": "<string>"
},
"useDestinationCalendarEmail": true,
"hideCalendarEventDetails": true,
"hideOrganizerEmail": true,
"calVideoSettings": {
"disableRecordingForOrganizer": false,
"disableRecordingForGuests": false,
"redirectUrlOnExit": "<string>",
"enableAutomaticRecordingForOrganizer": false,
"enableAutomaticTranscription": false,
"disableTranscriptionForGuests": false,
"disableTranscriptionForOrganizer": false,
"hideTranscriptionForGuests": false,
"hideTranscriptionForOrganizer": false,
"sendTranscriptionEmails": true,
"disableAttendeeRecordingDownloadEmail": false,
"transcriptionLanguage": "multi"
},
"disableCancelling": {
"disabled": true
},
"disableRescheduling": {
"disabled": true,
"minutesBefore": 60
},
"interfaceLanguage": "<string>",
"weekStart": "<string>",
"allowReschedulingPastBookings": true,
"allowReschedulingCancelledBookings": true,
"showOptimizedSlots": true,
"useIsolatedAvailability": true,
"privateNoteEnabled": true,
"privateNoteMode": "duplicate_event",
"privateNoteTemplate": "<string>",
"ownerId": 123,
"parentEventTypeId": 123,
"assignAllTeamMembers": true,
"rescheduleWithSameRoundRobinHost": true,
"allowRRHostChoiceOnReschedule": true,
"isRRWeightsEnabled": true
}
}Event Types
Create a team event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
If bookingFields is omitted, the event type is created with its default booking fields. At least one contact field—email or attendeePhoneNumber—must remain visible and required. Other default fields, such as additional notes, can be hidden. Provide bookingFields to customize the default fields or add custom booking fields. Required membership role: team admin. PBAC permission: eventType.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.
POST
/
v2
/
teams
/
{teamId}
/
event-types
Create a team event type
curl --request POST \
--url https://api.cal.com/v2/teams/{teamId}/event-types \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'cal-api-version: <cal-api-version>' \
--data '
{
"lengthInMinutes": 60,
"title": "Learn the secrets of masterchief!",
"slug": "learn-the-secrets-of-masterchief",
"schedulingType": "collective",
"calendarInvites": {
"host": {
"mode": "custom",
"template": "Meeting with {ATTENDEE}"
}
},
"lengthInMinutesOptions": [
15,
30,
60
],
"description": "Discover the culinary wonders of the Argentina by making the best flan ever!",
"slotInterval": 123,
"minimumBookingNotice": 1,
"beforeEventBuffer": 123,
"afterEventBuffer": 123,
"scheduleId": 123,
"bookingLimitsCount": {
"day": 1,
"week": 2,
"month": 3,
"year": 4
},
"bookerActiveBookingsLimit": {
"maximumActiveBookings": 3,
"offerReschedule": true,
"disabled": false
},
"onlyShowFirstAvailableSlot": true,
"bookingLimitsDuration": {
"day": 60,
"week": 120,
"month": 180,
"year": 240,
"disabled": false
},
"bookingWindow": {
"value": 5,
"rolling": true,
"disabled": false
},
"offsetStart": 1,
"confirmationPolicy": {
"type": "always",
"blockUnconfirmedBookingsInBooker": true,
"disabled": false
},
"recurrence": {
"interval": 1,
"occurrences": 10,
"disabled": false
},
"requiresBookerEmailVerification": true,
"skipAttendeeEmailDeliverabilityCheck": true,
"emailSettings": {
"disableEmailsToAttendees": true,
"disableEmailsToHosts": true,
"disableProposalEmailsToHosts": true
},
"hideCalendarNotes": true,
"lockTimeZoneToggleOnBookingPage": true,
"seats": {
"seatsPerTimeSlot": 4,
"showAttendeeInfo": true,
"showAvailabilityCount": true,
"disabled": false
},
"customName": "{Link title} between {Organiser} and {Scheduler}",
"useDestinationCalendarEmail": true,
"hideCalendarEventDetails": true,
"successRedirectUrl": "https://masterchief.com/argentina/flan/video/9129412",
"hideOrganizerEmail": true,
"calVideoSettings": {
"disableRecordingForOrganizer": false,
"disableRecordingForGuests": false,
"redirectUrlOnExit": "<string>",
"enableAutomaticRecordingForOrganizer": false,
"enableAutomaticTranscription": false,
"disableTranscriptionForGuests": false,
"disableTranscriptionForOrganizer": false,
"hideTranscriptionForGuests": false,
"hideTranscriptionForOrganizer": false,
"sendTranscriptionEmails": true,
"disableAttendeeRecordingDownloadEmail": false
},
"hidden": true,
"bookingRequiresAuthentication": false,
"disableCancelling": {
"disabled": true
},
"disableRescheduling": {
"disabled": false,
"minutesBefore": 60
},
"weekStart": "Monday",
"allowReschedulingPastBookings": false,
"allowReschedulingCancelledBookings": false,
"showOptimizedSlots": false,
"useIsolatedAvailability": false,
"privateNoteEnabled": false,
"privateNoteMode": "duplicate_event",
"privateNoteTemplate": "Meeting with {Attendee name} for {Link title}",
"hosts": [
{
"userId": 123,
"mandatory": false,
"priority": "medium",
"weight": 100
}
],
"assignAllTeamMembers": true,
"locations": [
{
"type": "address",
"address": "123 Example St, City, Country",
"public": true
}
],
"rescheduleWithSameRoundRobinHost": true,
"allowRRHostChoiceOnReschedule": true,
"isRRWeightsEnabled": true,
"bookingFields": [
{
"field": "name",
"variant": "fullName",
"slug": "name",
"label": "<string>",
"placeholder": "<string>",
"disableOnPrefill": true
}
],
"crm": {
"hubspot": {
"enabled": true,
"ignoreGuests": true,
"skipContactCreation": true
},
"salesforce": {
"enabled": true,
"ignoreGuests": true,
"skipContactCreation": true
}
}
}
'import requests
url = "https://api.cal.com/v2/teams/{teamId}/event-types"
payload = {
"lengthInMinutes": 60,
"title": "Learn the secrets of masterchief!",
"slug": "learn-the-secrets-of-masterchief",
"schedulingType": "collective",
"calendarInvites": { "host": {
"mode": "custom",
"template": "Meeting with {ATTENDEE}"
} },
"lengthInMinutesOptions": [15, 30, 60],
"description": "Discover the culinary wonders of the Argentina by making the best flan ever!",
"slotInterval": 123,
"minimumBookingNotice": 1,
"beforeEventBuffer": 123,
"afterEventBuffer": 123,
"scheduleId": 123,
"bookingLimitsCount": {
"day": 1,
"week": 2,
"month": 3,
"year": 4
},
"bookerActiveBookingsLimit": {
"maximumActiveBookings": 3,
"offerReschedule": True,
"disabled": False
},
"onlyShowFirstAvailableSlot": True,
"bookingLimitsDuration": {
"day": 60,
"week": 120,
"month": 180,
"year": 240,
"disabled": False
},
"bookingWindow": {
"value": 5,
"rolling": True,
"disabled": False
},
"offsetStart": 1,
"confirmationPolicy": {
"type": "always",
"blockUnconfirmedBookingsInBooker": True,
"disabled": False
},
"recurrence": {
"interval": 1,
"occurrences": 10,
"disabled": False
},
"requiresBookerEmailVerification": True,
"skipAttendeeEmailDeliverabilityCheck": True,
"emailSettings": {
"disableEmailsToAttendees": True,
"disableEmailsToHosts": True,
"disableProposalEmailsToHosts": True
},
"hideCalendarNotes": True,
"lockTimeZoneToggleOnBookingPage": True,
"seats": {
"seatsPerTimeSlot": 4,
"showAttendeeInfo": True,
"showAvailabilityCount": True,
"disabled": False
},
"customName": "{Link title} between {Organiser} and {Scheduler}",
"useDestinationCalendarEmail": True,
"hideCalendarEventDetails": True,
"successRedirectUrl": "https://masterchief.com/argentina/flan/video/9129412",
"hideOrganizerEmail": True,
"calVideoSettings": {
"disableRecordingForOrganizer": False,
"disableRecordingForGuests": False,
"redirectUrlOnExit": "<string>",
"enableAutomaticRecordingForOrganizer": False,
"enableAutomaticTranscription": False,
"disableTranscriptionForGuests": False,
"disableTranscriptionForOrganizer": False,
"hideTranscriptionForGuests": False,
"hideTranscriptionForOrganizer": False,
"sendTranscriptionEmails": True,
"disableAttendeeRecordingDownloadEmail": False
},
"hidden": True,
"bookingRequiresAuthentication": False,
"disableCancelling": { "disabled": True },
"disableRescheduling": {
"disabled": False,
"minutesBefore": 60
},
"weekStart": "Monday",
"allowReschedulingPastBookings": False,
"allowReschedulingCancelledBookings": False,
"showOptimizedSlots": False,
"useIsolatedAvailability": False,
"privateNoteEnabled": False,
"privateNoteMode": "duplicate_event",
"privateNoteTemplate": "Meeting with {Attendee name} for {Link title}",
"hosts": [
{
"userId": 123,
"mandatory": False,
"priority": "medium",
"weight": 100
}
],
"assignAllTeamMembers": True,
"locations": [
{
"type": "address",
"address": "123 Example St, City, Country",
"public": True
}
],
"rescheduleWithSameRoundRobinHost": True,
"allowRRHostChoiceOnReschedule": True,
"isRRWeightsEnabled": True,
"bookingFields": [
{
"field": "name",
"variant": "fullName",
"slug": "name",
"label": "<string>",
"placeholder": "<string>",
"disableOnPrefill": True
}
],
"crm": {
"hubspot": {
"enabled": True,
"ignoreGuests": True,
"skipContactCreation": True
},
"salesforce": {
"enabled": True,
"ignoreGuests": True,
"skipContactCreation": True
}
}
}
headers = {
"cal-api-version": "<cal-api-version>",
"Authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'cal-api-version': '<cal-api-version>',
Authorization: '<authorization>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
lengthInMinutes: 60,
title: 'Learn the secrets of masterchief!',
slug: 'learn-the-secrets-of-masterchief',
schedulingType: 'collective',
calendarInvites: {host: {mode: 'custom', template: 'Meeting with {ATTENDEE}'}},
lengthInMinutesOptions: [15, 30, 60],
description: 'Discover the culinary wonders of the Argentina by making the best flan ever!',
slotInterval: 123,
minimumBookingNotice: 1,
beforeEventBuffer: 123,
afterEventBuffer: 123,
scheduleId: 123,
bookingLimitsCount: {day: 1, week: 2, month: 3, year: 4},
bookerActiveBookingsLimit: {maximumActiveBookings: 3, offerReschedule: true, disabled: false},
onlyShowFirstAvailableSlot: true,
bookingLimitsDuration: {day: 60, week: 120, month: 180, year: 240, disabled: false},
bookingWindow: {value: 5, rolling: true, disabled: false},
offsetStart: 1,
confirmationPolicy: {type: 'always', blockUnconfirmedBookingsInBooker: true, disabled: false},
recurrence: {interval: 1, occurrences: 10, disabled: false},
requiresBookerEmailVerification: true,
skipAttendeeEmailDeliverabilityCheck: true,
emailSettings: {
disableEmailsToAttendees: true,
disableEmailsToHosts: true,
disableProposalEmailsToHosts: true
},
hideCalendarNotes: true,
lockTimeZoneToggleOnBookingPage: true,
seats: {
seatsPerTimeSlot: 4,
showAttendeeInfo: true,
showAvailabilityCount: true,
disabled: false
},
customName: '{Link title} between {Organiser} and {Scheduler}',
useDestinationCalendarEmail: true,
hideCalendarEventDetails: true,
successRedirectUrl: 'https://masterchief.com/argentina/flan/video/9129412',
hideOrganizerEmail: true,
calVideoSettings: {
disableRecordingForOrganizer: false,
disableRecordingForGuests: false,
redirectUrlOnExit: '<string>',
enableAutomaticRecordingForOrganizer: false,
enableAutomaticTranscription: false,
disableTranscriptionForGuests: false,
disableTranscriptionForOrganizer: false,
hideTranscriptionForGuests: false,
hideTranscriptionForOrganizer: false,
sendTranscriptionEmails: true,
disableAttendeeRecordingDownloadEmail: false
},
hidden: true,
bookingRequiresAuthentication: false,
disableCancelling: {disabled: true},
disableRescheduling: {disabled: false, minutesBefore: 60},
weekStart: 'Monday',
allowReschedulingPastBookings: false,
allowReschedulingCancelledBookings: false,
showOptimizedSlots: false,
useIsolatedAvailability: false,
privateNoteEnabled: false,
privateNoteMode: 'duplicate_event',
privateNoteTemplate: 'Meeting with {Attendee name} for {Link title}',
hosts: [{userId: 123, mandatory: false, priority: 'medium', weight: 100}],
assignAllTeamMembers: true,
locations: [{type: 'address', address: '123 Example St, City, Country', public: true}],
rescheduleWithSameRoundRobinHost: true,
allowRRHostChoiceOnReschedule: true,
isRRWeightsEnabled: true,
bookingFields: [
{
field: 'name',
variant: 'fullName',
slug: 'name',
label: '<string>',
placeholder: '<string>',
disableOnPrefill: true
}
],
crm: {
hubspot: {enabled: true, ignoreGuests: true, skipContactCreation: true},
salesforce: {enabled: true, ignoreGuests: true, skipContactCreation: true}
}
})
};
fetch('https://api.cal.com/v2/teams/{teamId}/event-types', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cal.com/v2/teams/{teamId}/event-types",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'lengthInMinutes' => 60,
'title' => 'Learn the secrets of masterchief!',
'slug' => 'learn-the-secrets-of-masterchief',
'schedulingType' => 'collective',
'calendarInvites' => [
'host' => [
'mode' => 'custom',
'template' => 'Meeting with {ATTENDEE}'
]
],
'lengthInMinutesOptions' => [
15,
30,
60
],
'description' => 'Discover the culinary wonders of the Argentina by making the best flan ever!',
'slotInterval' => 123,
'minimumBookingNotice' => 1,
'beforeEventBuffer' => 123,
'afterEventBuffer' => 123,
'scheduleId' => 123,
'bookingLimitsCount' => [
'day' => 1,
'week' => 2,
'month' => 3,
'year' => 4
],
'bookerActiveBookingsLimit' => [
'maximumActiveBookings' => 3,
'offerReschedule' => true,
'disabled' => false
],
'onlyShowFirstAvailableSlot' => true,
'bookingLimitsDuration' => [
'day' => 60,
'week' => 120,
'month' => 180,
'year' => 240,
'disabled' => false
],
'bookingWindow' => [
'value' => 5,
'rolling' => true,
'disabled' => false
],
'offsetStart' => 1,
'confirmationPolicy' => [
'type' => 'always',
'blockUnconfirmedBookingsInBooker' => true,
'disabled' => false
],
'recurrence' => [
'interval' => 1,
'occurrences' => 10,
'disabled' => false
],
'requiresBookerEmailVerification' => true,
'skipAttendeeEmailDeliverabilityCheck' => true,
'emailSettings' => [
'disableEmailsToAttendees' => true,
'disableEmailsToHosts' => true,
'disableProposalEmailsToHosts' => true
],
'hideCalendarNotes' => true,
'lockTimeZoneToggleOnBookingPage' => true,
'seats' => [
'seatsPerTimeSlot' => 4,
'showAttendeeInfo' => true,
'showAvailabilityCount' => true,
'disabled' => false
],
'customName' => '{Link title} between {Organiser} and {Scheduler}',
'useDestinationCalendarEmail' => true,
'hideCalendarEventDetails' => true,
'successRedirectUrl' => 'https://masterchief.com/argentina/flan/video/9129412',
'hideOrganizerEmail' => true,
'calVideoSettings' => [
'disableRecordingForOrganizer' => false,
'disableRecordingForGuests' => false,
'redirectUrlOnExit' => '<string>',
'enableAutomaticRecordingForOrganizer' => false,
'enableAutomaticTranscription' => false,
'disableTranscriptionForGuests' => false,
'disableTranscriptionForOrganizer' => false,
'hideTranscriptionForGuests' => false,
'hideTranscriptionForOrganizer' => false,
'sendTranscriptionEmails' => true,
'disableAttendeeRecordingDownloadEmail' => false
],
'hidden' => true,
'bookingRequiresAuthentication' => false,
'disableCancelling' => [
'disabled' => true
],
'disableRescheduling' => [
'disabled' => false,
'minutesBefore' => 60
],
'weekStart' => 'Monday',
'allowReschedulingPastBookings' => false,
'allowReschedulingCancelledBookings' => false,
'showOptimizedSlots' => false,
'useIsolatedAvailability' => false,
'privateNoteEnabled' => false,
'privateNoteMode' => 'duplicate_event',
'privateNoteTemplate' => 'Meeting with {Attendee name} for {Link title}',
'hosts' => [
[
'userId' => 123,
'mandatory' => false,
'priority' => 'medium',
'weight' => 100
]
],
'assignAllTeamMembers' => true,
'locations' => [
[
'type' => 'address',
'address' => '123 Example St, City, Country',
'public' => true
]
],
'rescheduleWithSameRoundRobinHost' => true,
'allowRRHostChoiceOnReschedule' => true,
'isRRWeightsEnabled' => true,
'bookingFields' => [
[
'field' => 'name',
'variant' => 'fullName',
'slug' => 'name',
'label' => '<string>',
'placeholder' => '<string>',
'disableOnPrefill' => true
]
],
'crm' => [
'hubspot' => [
'enabled' => true,
'ignoreGuests' => true,
'skipContactCreation' => true
],
'salesforce' => [
'enabled' => true,
'ignoreGuests' => true,
'skipContactCreation' => true
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json",
"cal-api-version: <cal-api-version>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.cal.com/v2/teams/{teamId}/event-types"
payload := strings.NewReader("{\n \"lengthInMinutes\": 60,\n \"title\": \"Learn the secrets of masterchief!\",\n \"slug\": \"learn-the-secrets-of-masterchief\",\n \"schedulingType\": \"collective\",\n \"calendarInvites\": {\n \"host\": {\n \"mode\": \"custom\",\n \"template\": \"Meeting with {ATTENDEE}\"\n }\n },\n \"lengthInMinutesOptions\": [\n 15,\n 30,\n 60\n ],\n \"description\": \"Discover the culinary wonders of the Argentina by making the best flan ever!\",\n \"slotInterval\": 123,\n \"minimumBookingNotice\": 1,\n \"beforeEventBuffer\": 123,\n \"afterEventBuffer\": 123,\n \"scheduleId\": 123,\n \"bookingLimitsCount\": {\n \"day\": 1,\n \"week\": 2,\n \"month\": 3,\n \"year\": 4\n },\n \"bookerActiveBookingsLimit\": {\n \"maximumActiveBookings\": 3,\n \"offerReschedule\": true,\n \"disabled\": false\n },\n \"onlyShowFirstAvailableSlot\": true,\n \"bookingLimitsDuration\": {\n \"day\": 60,\n \"week\": 120,\n \"month\": 180,\n \"year\": 240,\n \"disabled\": false\n },\n \"bookingWindow\": {\n \"value\": 5,\n \"rolling\": true,\n \"disabled\": false\n },\n \"offsetStart\": 1,\n \"confirmationPolicy\": {\n \"type\": \"always\",\n \"blockUnconfirmedBookingsInBooker\": true,\n \"disabled\": false\n },\n \"recurrence\": {\n \"interval\": 1,\n \"occurrences\": 10,\n \"disabled\": false\n },\n \"requiresBookerEmailVerification\": true,\n \"skipAttendeeEmailDeliverabilityCheck\": true,\n \"emailSettings\": {\n \"disableEmailsToAttendees\": true,\n \"disableEmailsToHosts\": true,\n \"disableProposalEmailsToHosts\": true\n },\n \"hideCalendarNotes\": true,\n \"lockTimeZoneToggleOnBookingPage\": true,\n \"seats\": {\n \"seatsPerTimeSlot\": 4,\n \"showAttendeeInfo\": true,\n \"showAvailabilityCount\": true,\n \"disabled\": false\n },\n \"customName\": \"{Link title} between {Organiser} and {Scheduler}\",\n \"useDestinationCalendarEmail\": true,\n \"hideCalendarEventDetails\": true,\n \"successRedirectUrl\": \"https://masterchief.com/argentina/flan/video/9129412\",\n \"hideOrganizerEmail\": true,\n \"calVideoSettings\": {\n \"disableRecordingForOrganizer\": false,\n \"disableRecordingForGuests\": false,\n \"redirectUrlOnExit\": \"<string>\",\n \"enableAutomaticRecordingForOrganizer\": false,\n \"enableAutomaticTranscription\": false,\n \"disableTranscriptionForGuests\": false,\n \"disableTranscriptionForOrganizer\": false,\n \"hideTranscriptionForGuests\": false,\n \"hideTranscriptionForOrganizer\": false,\n \"sendTranscriptionEmails\": true,\n \"disableAttendeeRecordingDownloadEmail\": false\n },\n \"hidden\": true,\n \"bookingRequiresAuthentication\": false,\n \"disableCancelling\": {\n \"disabled\": true\n },\n \"disableRescheduling\": {\n \"disabled\": false,\n \"minutesBefore\": 60\n },\n \"weekStart\": \"Monday\",\n \"allowReschedulingPastBookings\": false,\n \"allowReschedulingCancelledBookings\": false,\n \"showOptimizedSlots\": false,\n \"useIsolatedAvailability\": false,\n \"privateNoteEnabled\": false,\n \"privateNoteMode\": \"duplicate_event\",\n \"privateNoteTemplate\": \"Meeting with {Attendee name} for {Link title}\",\n \"hosts\": [\n {\n \"userId\": 123,\n \"mandatory\": false,\n \"priority\": \"medium\",\n \"weight\": 100\n }\n ],\n \"assignAllTeamMembers\": true,\n \"locations\": [\n {\n \"type\": \"address\",\n \"address\": \"123 Example St, City, Country\",\n \"public\": true\n }\n ],\n \"rescheduleWithSameRoundRobinHost\": true,\n \"allowRRHostChoiceOnReschedule\": true,\n \"isRRWeightsEnabled\": true,\n \"bookingFields\": [\n {\n \"field\": \"name\",\n \"variant\": \"fullName\",\n \"slug\": \"name\",\n \"label\": \"<string>\",\n \"placeholder\": \"<string>\",\n \"disableOnPrefill\": true\n }\n ],\n \"crm\": {\n \"hubspot\": {\n \"enabled\": true,\n \"ignoreGuests\": true,\n \"skipContactCreation\": true\n },\n \"salesforce\": {\n \"enabled\": true,\n \"ignoreGuests\": true,\n \"skipContactCreation\": true\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("cal-api-version", "<cal-api-version>")
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.cal.com/v2/teams/{teamId}/event-types")
.header("cal-api-version", "<cal-api-version>")
.header("Authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"lengthInMinutes\": 60,\n \"title\": \"Learn the secrets of masterchief!\",\n \"slug\": \"learn-the-secrets-of-masterchief\",\n \"schedulingType\": \"collective\",\n \"calendarInvites\": {\n \"host\": {\n \"mode\": \"custom\",\n \"template\": \"Meeting with {ATTENDEE}\"\n }\n },\n \"lengthInMinutesOptions\": [\n 15,\n 30,\n 60\n ],\n \"description\": \"Discover the culinary wonders of the Argentina by making the best flan ever!\",\n \"slotInterval\": 123,\n \"minimumBookingNotice\": 1,\n \"beforeEventBuffer\": 123,\n \"afterEventBuffer\": 123,\n \"scheduleId\": 123,\n \"bookingLimitsCount\": {\n \"day\": 1,\n \"week\": 2,\n \"month\": 3,\n \"year\": 4\n },\n \"bookerActiveBookingsLimit\": {\n \"maximumActiveBookings\": 3,\n \"offerReschedule\": true,\n \"disabled\": false\n },\n \"onlyShowFirstAvailableSlot\": true,\n \"bookingLimitsDuration\": {\n \"day\": 60,\n \"week\": 120,\n \"month\": 180,\n \"year\": 240,\n \"disabled\": false\n },\n \"bookingWindow\": {\n \"value\": 5,\n \"rolling\": true,\n \"disabled\": false\n },\n \"offsetStart\": 1,\n \"confirmationPolicy\": {\n \"type\": \"always\",\n \"blockUnconfirmedBookingsInBooker\": true,\n \"disabled\": false\n },\n \"recurrence\": {\n \"interval\": 1,\n \"occurrences\": 10,\n \"disabled\": false\n },\n \"requiresBookerEmailVerification\": true,\n \"skipAttendeeEmailDeliverabilityCheck\": true,\n \"emailSettings\": {\n \"disableEmailsToAttendees\": true,\n \"disableEmailsToHosts\": true,\n \"disableProposalEmailsToHosts\": true\n },\n \"hideCalendarNotes\": true,\n \"lockTimeZoneToggleOnBookingPage\": true,\n \"seats\": {\n \"seatsPerTimeSlot\": 4,\n \"showAttendeeInfo\": true,\n \"showAvailabilityCount\": true,\n \"disabled\": false\n },\n \"customName\": \"{Link title} between {Organiser} and {Scheduler}\",\n \"useDestinationCalendarEmail\": true,\n \"hideCalendarEventDetails\": true,\n \"successRedirectUrl\": \"https://masterchief.com/argentina/flan/video/9129412\",\n \"hideOrganizerEmail\": true,\n \"calVideoSettings\": {\n \"disableRecordingForOrganizer\": false,\n \"disableRecordingForGuests\": false,\n \"redirectUrlOnExit\": \"<string>\",\n \"enableAutomaticRecordingForOrganizer\": false,\n \"enableAutomaticTranscription\": false,\n \"disableTranscriptionForGuests\": false,\n \"disableTranscriptionForOrganizer\": false,\n \"hideTranscriptionForGuests\": false,\n \"hideTranscriptionForOrganizer\": false,\n \"sendTranscriptionEmails\": true,\n \"disableAttendeeRecordingDownloadEmail\": false\n },\n \"hidden\": true,\n \"bookingRequiresAuthentication\": false,\n \"disableCancelling\": {\n \"disabled\": true\n },\n \"disableRescheduling\": {\n \"disabled\": false,\n \"minutesBefore\": 60\n },\n \"weekStart\": \"Monday\",\n \"allowReschedulingPastBookings\": false,\n \"allowReschedulingCancelledBookings\": false,\n \"showOptimizedSlots\": false,\n \"useIsolatedAvailability\": false,\n \"privateNoteEnabled\": false,\n \"privateNoteMode\": \"duplicate_event\",\n \"privateNoteTemplate\": \"Meeting with {Attendee name} for {Link title}\",\n \"hosts\": [\n {\n \"userId\": 123,\n \"mandatory\": false,\n \"priority\": \"medium\",\n \"weight\": 100\n }\n ],\n \"assignAllTeamMembers\": true,\n \"locations\": [\n {\n \"type\": \"address\",\n \"address\": \"123 Example St, City, Country\",\n \"public\": true\n }\n ],\n \"rescheduleWithSameRoundRobinHost\": true,\n \"allowRRHostChoiceOnReschedule\": true,\n \"isRRWeightsEnabled\": true,\n \"bookingFields\": [\n {\n \"field\": \"name\",\n \"variant\": \"fullName\",\n \"slug\": \"name\",\n \"label\": \"<string>\",\n \"placeholder\": \"<string>\",\n \"disableOnPrefill\": true\n }\n ],\n \"crm\": {\n \"hubspot\": {\n \"enabled\": true,\n \"ignoreGuests\": true,\n \"skipContactCreation\": true\n },\n \"salesforce\": {\n \"enabled\": true,\n \"ignoreGuests\": true,\n \"skipContactCreation\": true\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cal.com/v2/teams/{teamId}/event-types")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["cal-api-version"] = '<cal-api-version>'
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"lengthInMinutes\": 60,\n \"title\": \"Learn the secrets of masterchief!\",\n \"slug\": \"learn-the-secrets-of-masterchief\",\n \"schedulingType\": \"collective\",\n \"calendarInvites\": {\n \"host\": {\n \"mode\": \"custom\",\n \"template\": \"Meeting with {ATTENDEE}\"\n }\n },\n \"lengthInMinutesOptions\": [\n 15,\n 30,\n 60\n ],\n \"description\": \"Discover the culinary wonders of the Argentina by making the best flan ever!\",\n \"slotInterval\": 123,\n \"minimumBookingNotice\": 1,\n \"beforeEventBuffer\": 123,\n \"afterEventBuffer\": 123,\n \"scheduleId\": 123,\n \"bookingLimitsCount\": {\n \"day\": 1,\n \"week\": 2,\n \"month\": 3,\n \"year\": 4\n },\n \"bookerActiveBookingsLimit\": {\n \"maximumActiveBookings\": 3,\n \"offerReschedule\": true,\n \"disabled\": false\n },\n \"onlyShowFirstAvailableSlot\": true,\n \"bookingLimitsDuration\": {\n \"day\": 60,\n \"week\": 120,\n \"month\": 180,\n \"year\": 240,\n \"disabled\": false\n },\n \"bookingWindow\": {\n \"value\": 5,\n \"rolling\": true,\n \"disabled\": false\n },\n \"offsetStart\": 1,\n \"confirmationPolicy\": {\n \"type\": \"always\",\n \"blockUnconfirmedBookingsInBooker\": true,\n \"disabled\": false\n },\n \"recurrence\": {\n \"interval\": 1,\n \"occurrences\": 10,\n \"disabled\": false\n },\n \"requiresBookerEmailVerification\": true,\n \"skipAttendeeEmailDeliverabilityCheck\": true,\n \"emailSettings\": {\n \"disableEmailsToAttendees\": true,\n \"disableEmailsToHosts\": true,\n \"disableProposalEmailsToHosts\": true\n },\n \"hideCalendarNotes\": true,\n \"lockTimeZoneToggleOnBookingPage\": true,\n \"seats\": {\n \"seatsPerTimeSlot\": 4,\n \"showAttendeeInfo\": true,\n \"showAvailabilityCount\": true,\n \"disabled\": false\n },\n \"customName\": \"{Link title} between {Organiser} and {Scheduler}\",\n \"useDestinationCalendarEmail\": true,\n \"hideCalendarEventDetails\": true,\n \"successRedirectUrl\": \"https://masterchief.com/argentina/flan/video/9129412\",\n \"hideOrganizerEmail\": true,\n \"calVideoSettings\": {\n \"disableRecordingForOrganizer\": false,\n \"disableRecordingForGuests\": false,\n \"redirectUrlOnExit\": \"<string>\",\n \"enableAutomaticRecordingForOrganizer\": false,\n \"enableAutomaticTranscription\": false,\n \"disableTranscriptionForGuests\": false,\n \"disableTranscriptionForOrganizer\": false,\n \"hideTranscriptionForGuests\": false,\n \"hideTranscriptionForOrganizer\": false,\n \"sendTranscriptionEmails\": true,\n \"disableAttendeeRecordingDownloadEmail\": false\n },\n \"hidden\": true,\n \"bookingRequiresAuthentication\": false,\n \"disableCancelling\": {\n \"disabled\": true\n },\n \"disableRescheduling\": {\n \"disabled\": false,\n \"minutesBefore\": 60\n },\n \"weekStart\": \"Monday\",\n \"allowReschedulingPastBookings\": false,\n \"allowReschedulingCancelledBookings\": false,\n \"showOptimizedSlots\": false,\n \"useIsolatedAvailability\": false,\n \"privateNoteEnabled\": false,\n \"privateNoteMode\": \"duplicate_event\",\n \"privateNoteTemplate\": \"Meeting with {Attendee name} for {Link title}\",\n \"hosts\": [\n {\n \"userId\": 123,\n \"mandatory\": false,\n \"priority\": \"medium\",\n \"weight\": 100\n }\n ],\n \"assignAllTeamMembers\": true,\n \"locations\": [\n {\n \"type\": \"address\",\n \"address\": \"123 Example St, City, Country\",\n \"public\": true\n }\n ],\n \"rescheduleWithSameRoundRobinHost\": true,\n \"allowRRHostChoiceOnReschedule\": true,\n \"isRRWeightsEnabled\": true,\n \"bookingFields\": [\n {\n \"field\": \"name\",\n \"variant\": \"fullName\",\n \"slug\": \"name\",\n \"label\": \"<string>\",\n \"placeholder\": \"<string>\",\n \"disableOnPrefill\": true\n }\n ],\n \"crm\": {\n \"hubspot\": {\n \"enabled\": true,\n \"ignoreGuests\": true,\n \"skipContactCreation\": true\n },\n \"salesforce\": {\n \"enabled\": true,\n \"ignoreGuests\": true,\n \"skipContactCreation\": true\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"id": 1,
"lengthInMinutes": 60,
"title": "Learn the secrets of masterchief!",
"slug": "learn-the-secrets-of-masterchief",
"description": "Discover the culinary wonders of Argentina by making the best flan ever!",
"locations": [
{
"type": "address",
"address": "123 Example St, City, Country",
"public": true
}
],
"disableGuests": true,
"recurrence": {
"interval": 1,
"occurrences": 10,
"frequency": "yearly",
"disabled": false
},
"metadata": {},
"price": 123,
"currency": "<string>",
"lockTimeZoneToggleOnBookingPage": true,
"forwardParamsSuccessRedirect": true,
"successRedirectUrl": "<string>",
"isInstantEvent": true,
"scheduleId": 123,
"hidden": true,
"bookingRequiresAuthentication": true,
"teamId": 123,
"bookingUrl": "https://cal.com/team/acme/30min",
"hosts": [
{
"userId": 123,
"name": "John Doe",
"username": "john-doe",
"mandatory": false,
"priority": "medium",
"weight": 100,
"userUuid": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
"avatarUrl": "https://cal.com/api/avatar/d95949bc-ccb1-400f-acf6-045c51a16856.png"
}
],
"schedulingType": "roundRobin",
"team": {
"id": 123,
"slug": "<string>",
"bannerUrl": "<string>",
"name": "<string>",
"logoUrl": "<string>",
"weekStart": "<string>",
"brandColor": "<string>",
"darkBrandColor": "<string>",
"theme": "<string>"
},
"bookingFields": [
{
"field": "name",
"slug": "name",
"variant": "fullName",
"disableOnPrefill": true,
"label": "<string>",
"placeholder": "<string>"
}
],
"crm": {
"hubspot": {
"enabled": true,
"ignoreGuests": true,
"skipContactCreation": true
},
"salesforce": {
"enabled": true,
"ignoreGuests": true,
"skipContactCreation": true
}
},
"lengthInMinutesOptions": [
15,
30,
60
],
"slotInterval": 60,
"minimumBookingNotice": 0,
"beforeEventBuffer": 0,
"afterEventBuffer": 0,
"seatsPerTimeSlot": 123,
"seatsShowAvailabilityCount": true,
"bookingLimitsCount": {
"day": 1,
"week": 2,
"month": 3,
"year": 4
},
"bookerActiveBookingsLimit": {
"maximumActiveBookings": 3,
"offerReschedule": true
},
"onlyShowFirstAvailableSlot": true,
"bookingLimitsDuration": {
"day": 60,
"week": 120,
"month": 180,
"year": 240,
"disabled": false
},
"bookingWindow": [
{
"type": "businessDays",
"value": 5,
"rolling": true,
"disabled": false
}
],
"bookerLayouts": {
"defaultLayout": "month",
"enabledLayouts": [
"month"
]
},
"confirmationPolicy": {
"type": "always",
"blockUnconfirmedBookingsInBooker": true,
"noticeThreshold": {
"unit": "minutes",
"count": 30
},
"disabled": false
},
"bookingProposalCount": 123,
"requiresBookerEmailVerification": true,
"skipAttendeeEmailDeliverabilityCheck": true,
"emailSettings": {
"disableEmailsToAttendees": true,
"disableEmailsToHosts": true,
"disableProposalEmailsToHosts": true
},
"hideCalendarNotes": true,
"color": {
"lightThemeHex": "#292929",
"darkThemeHex": "#fafafa"
},
"seats": {
"seatsPerTimeSlot": 4,
"showAttendeeInfo": true,
"showAvailabilityCount": true,
"disabled": false
},
"offsetStart": 123,
"customName": "<string>",
"destinationCalendar": {
"integration": "<string>",
"externalId": "<string>"
},
"useDestinationCalendarEmail": true,
"hideCalendarEventDetails": true,
"hideOrganizerEmail": true,
"calVideoSettings": {
"disableRecordingForOrganizer": false,
"disableRecordingForGuests": false,
"redirectUrlOnExit": "<string>",
"enableAutomaticRecordingForOrganizer": false,
"enableAutomaticTranscription": false,
"disableTranscriptionForGuests": false,
"disableTranscriptionForOrganizer": false,
"hideTranscriptionForGuests": false,
"hideTranscriptionForOrganizer": false,
"sendTranscriptionEmails": true,
"disableAttendeeRecordingDownloadEmail": false,
"transcriptionLanguage": "multi"
},
"disableCancelling": {
"disabled": true
},
"disableRescheduling": {
"disabled": true,
"minutesBefore": 60
},
"interfaceLanguage": "<string>",
"weekStart": "<string>",
"allowReschedulingPastBookings": true,
"allowReschedulingCancelledBookings": true,
"showOptimizedSlots": true,
"useIsolatedAvailability": true,
"privateNoteEnabled": true,
"privateNoteMode": "duplicate_event",
"privateNoteTemplate": "<string>",
"ownerId": 123,
"parentEventTypeId": 123,
"assignAllTeamMembers": true,
"rescheduleWithSameRoundRobinHost": true,
"allowRRHostChoiceOnReschedule": true,
"isRRWeightsEnabled": true
}
}Headers
Must be set to 2026-06-12. If not set to this value, the endpoint will default to an older version.
Example:
"2026-06-12"
value must be Bearer <token> where <token> is api key prefixed with cal_, managed user access token, or OAuth access token
Path Parameters
The team's uuid (preferred), its short-uuid (Flickr Base58) form, or its numeric id.
Body
application/json
Required range:
x >= 1Example:
60
Example:
"Learn the secrets of masterchief!"
Example:
"learn-the-secrets-of-masterchief"
The scheduling type for the team event - collective, roundRobin or managed.
Available options:
collective, roundRobin, managed Example:
"collective"
Write-only host and guest calendar-invite description settings. These are saved separately from the event type and are not returned by event-type read endpoints.
Show child attributes
Show child attributes
Example:
{ "host": { "mode": "custom", "template": "Meeting with {ATTENDEE}" } }
If you want that user can choose between different lengths of the event you can specify them here. Must include the provided lengthInMinutes.
Minimum array length:
1Required range:
x >= 1Example:
[15, 30, 60]
Example:
"Discover the culinary wonders of the Argentina by making the best flan ever!"
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.
Minimum number of minutes before the event that a booking can be made.
Required range:
x >= 0Extra time automatically blocked on your calendar before a meeting starts. This gives you time to prepare, review notes, or transition from your previous activity.
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.
If you want that this event has different schedule than user's default one you can specify it here.
Limit how many times this event can be booked
- Booking Count Limit
- Disabled
Show child attributes
Show child attributes
Limit the number of active bookings a booker can make for this event type.
- Active Booking Limit
- Disabled
Show child attributes
Show child attributes
This will limit your availability for this event type to one slot per day, scheduled at the earliest available time.
Limit total amount of time that this event can be booked
- Booking Duration Limit
- Disabled
Show child attributes
Show child attributes
Limit how far in the future this event can be booked
- Business Days
- Calendar Days
- Date Range
- Disabled
Show child attributes
Show child attributes
Offset timeslots shown to bookers by a specified number of minutes
Required range:
x >= 0Should booker have week, month or column view. Specify default layout and enabled layouts user can pick.
Show child attributes
Show child attributes
Specify how the booking needs to be manually confirmed before it is pushed to the integrations and a confirmation mail is sent.
- Confirmation Required
- Disabled
Show child attributes
Show child attributes
Create a recurring event type.
- Recurring Event
- Disabled
Show child attributes
Show child attributes
When true, skips the MX deliverability check for attendee emails on booking. Format validation and watchlist still apply. Requires the editor to belong to an organization (including platform orgs).
Email settings for this event type. Personal event types require an accepted organization membership; team event types require an organization team. This does not include emails sent by custom email workflows.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Create an event type with multiple seats.
- Seated Event
- Disabled
Show child attributes
Show child attributes
Customizable event name with valid variables: {Link title}, {Event type title} (legacy), {Organiser}, {Scheduler}, {Location}, {Organiser first name}, {Scheduler first name}, {Scheduler last name}, {Event duration}, {LOCATION}, {HOST/ATTENDEE}, {HOST}, {ATTENDEE}, {USER}
Example:
"{Link title} between {Organiser} and {Scheduler}"
Show child attributes
Show child attributes
A valid URL where the booker will redirect to, once the booking is completed successfully
Example:
"https://masterchief.com/argentina/flan/video/9129412"
Boolean to Hide organizer's email address from the booking screen, email notifications, and calendar events
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.
Show child attributes
Show child attributes
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.
Settings for disabling cancelling of this event type.
Show child attributes
Show child attributes
Example:
{ "disabled": true }
Settings for disabling rescheduling of this event type. Can be always disabled or disabled when less than X minutes before the meeting.
Show child attributes
Show child attributes
Example:
{ "disabled": false, "minutesBefore": 60 }
Set preferred language for the booking interface. Use empty string for visitor's browser language (default).
Available options:
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, sl, sr, sv, tr, uk, vi, zh-CN, zh-TW Day the booking page calendar starts the week on. Overrides the host's account setting for this event type only. Omit or set to null to inherit the account setting.
Available options:
Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday Example:
"Monday"
Enabling this option allows for past events to be rescheduled.
When enabled, users will be able to create a new booking when trying to reschedule a cancelled booking.
Arrange time slots to optimize availability.
When true, only this event type's own Cal.com bookings block the slot. The availability schedule and connected calendars still apply. Same as "Consider only this booking link's bookings" in the web app. Requires an organization with at least 15 members.
When enabled, a private note calendar event is created alongside the booking with the resolved template as its description. Only visible to the host.
How private notes are delivered: as an additional host event or by sending separate host and guest invites.
Available options:
duplicate_event, separate_events Example:
"duplicate_event"
Template for the private note content. Supports variables like {Attendee name}, {Link title}, {Event type title} (legacy), {Location}, {Host name}, {Event duration}, and custom booking field names.
Example:
"Meeting with {Attendee name} for {Link title}"
Hosts contain specific team members you want to assign to this event type. To assign every current and future team member use assignAllTeamMembers: true and omit this field. As an exception, round robin event types accept hosts together with assignAllTeamMembers: true to mark specific team members as fixed hosts (entries with mandatory: true); non-mandatory entries are silently ignored in that combination because they would be added to the round robin pool by assignAllTeamMembers anyway. For platform customers the hosts can include userIds only of managed users.
Show child attributes
Show child attributes
If true, all current and future team members will be assigned to this event type. Mutually exclusive with hosts for collective and managed event types. For round robin event types, hosts may be provided alongside assignAllTeamMembers: true solely to designate fixed hosts via mandatory: true entries.
locations
(Address · object | Link · object | Integration · object | Phone · object | Attendee Address · object | Attendee Phone · object | Attendee Defined · object | Organizer Default App · object)[]
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.
- Address
- Link
- Integration
- Phone
- Attendee Address
- Attendee Phone
- Attendee Defined
- Organizer Default App
Show child attributes
Show child attributes
Rescheduled events will be assigned to the same host as initially scheduled.
Let the person rescheduling choose between keeping the original host and letting round robin pick from the whole team. Requires rescheduleWithSameRoundRobinHost to be enabled.
Only relevant for round robin event types. If true, bookings are distributed according to each host's weight instead of evenly.
bookingFields
(Default Full Name · object | Default Split Name · object | Default Email · object | Default Location · object | Default Title · object | Default Notes · object | Default Guests · object | Default Reschedule Reason · object | Default Attendee Phone · object | Workflow-added SMS Reminder · object | Workflow-added AI Agent Phone · object | Custom Email · object | Custom Phone · object | Custom Address · object | Custom Short Text · object | Custom Number · object | Custom Long Text · object | Custom Select · object | Custom Multi-Select · object | Custom Multiple Emails · object | Custom Checkbox Group · object | Custom Checkbox · object | Custom Radio Group · object | Custom URL · object)[]
Booking fields for the event type. Omit this property to use the default fields. Provide an array to customize default fields or add custom booking fields. At least one of email or attendeePhoneNumber must be visible and required. The array cannot be empty, contain duplicate default fields or custom slugs, or use a default field's slug for a custom field. Omitted default fields are added with their default settings. Workflow-added fields are read-only and ignored.
- Default Full Name
- Default Split Name
- Default Email
- Default Location
- Default Title
- Default Notes
- Default Guests
- Default Reschedule Reason
- Default Attendee Phone
- Workflow-added SMS Reminder
- Workflow-added AI Agent Phone
- Custom Email
- Custom Phone
- Custom Address
- Custom Short Text
- Custom Number
- Custom Long Text
- Custom Select
- Custom Multi-Select
- Custom Multiple Emails
- Custom Checkbox Group
- Custom Checkbox
- Custom Radio Group
- Custom URL
Show child attributes
Show child attributes
CRM app settings for the event type, mirroring the event type Apps tab toggles. The credential is resolved server-side — the app must be installed for the event type owner.
Show child attributes
Show child attributes
Was this page helpful?