How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Calendly Event Types API

The eventTypes API from Calendly — 5 operation(s) for eventtypes.

Calendly Event Types API is one of 18 APIs that Calendly publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Event Types. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 7 operations across 5 paths, and defines 131 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.calendly.com.

7 operations 5 paths 131 schemas 4 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.calendly.com
Authentication
HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Calendly Event Types API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (oauth2). It accepts HTTP bearer tokens (personal_access_token).

  • oauth2 — OAuth 2.0
  • personal_access_token — Personal Access Token

Paths & Operations 7

Across 5 paths, the API surfaces 7 operations — 4 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

eventTypes 7
POST
/event_types
Create Event Type
eventTypes_create-event-type body → 201400401403404500
GET
/event_types
List User's Event Types
eventTypes_list-event-types 8 params → 200400401403404500
POST
/one_off_event_types
Create One-Off Event Type
eventTypes_create-one-off-event-type body → 201400401403404500
GET
/event_types/{uuid}
Get Event Type
eventTypes_get-event-type 1 param → 200400401403404500
PATCH
/event_types/{uuid}
Update Event Type
eventTypes_update-event-type 1 param body → 200400401403404500
GET
/event_type_available_times
List Event Type Available Times
eventTypes_list-event-type-available-times 3 params → 200400401403404500
GET
/event_type_memberships
List Event Type Hosts
eventTypes_list-event-type-memberships 3 params → 200400401403404500

Schemas 131

The contract defines 131 schemas that model the data the API accepts and returns. The most detailed are EventType (26 properties), User (13 properties), EventTypeCustomQuestion (7 properties), Pagination (5 properties). Each schema is shown below with its type and property counts.

List-event-type-membershipsRequestNotFoundError
object
Error Object
3 properties 2 required
Spots
object
Only allow scheduling with dedicated time spots
2 properties 2 required
InsufficientScopeError
object
Caller does not have required oauth scopes
3 properties 3 required
AdhocMicrosoftTeamsConferenceKind
string
EventTypesError
object
Permission Denied
2 properties
DaysInFutureType
string
EventTypeAvailableTimesGetResponsesContentApplicationJsonSchemaMessage
string
ListEventTypeAvailableTimesRequestForbiddenError0
object
Error Object
3 properties 2 required
EventTypeCustomQuestion
object
7 properties 7 required
eventTypes_list-event-type-available-times_Response_200
object
Service Response
1 property 1 required
EventTypeMembershipsGetResponsesContentApplicationJsonSchemaMessage
string
AdhocCustomLocationKind
string
EventTypesErrorMessage
string
Create-event-typeRequestUnauthorizedError
object
Error Object
3 properties 2 required
ListEventTypeMembershipsRequestForbiddenError0
object
Error Object
3 properties 2 required
OneOffEventTypesPostResponsesContentApplicationJsonSchemaTitle
string
EventTypesUuidPatchResponsesContentApplicationJsonSchemaOneOf0Message
string
OneOffEventTypesPostResponsesContentApplicationJsonSchemaMessage
string
OneOffEventsErrorMessage
string
Get-event-typeRequestUnauthorizedError
object
Error Object
3 properties 2 required
DaysInFuture
object
Only allow scheduling for N days into the future from now
3 properties 3 required
EventTypeAvailableTimesGetResponsesContentApplicationJsonSchemaOneOf0Message
string
List-event-type-available-timesRequestUnauthorizedError
object
Error Object
3 properties 2 required
EventTypeMembershipsGetResponsesContentApplicationJsonSchemaOneOf0Message
string
ProfileType
string
Indicates if the profile belongs to a "user" (individual) or "team"
EventTypesUuidPatchResponsesContentApplicationJsonSchemaOneOf0Title
string
List-event-type-available-timesRequestNotFoundError
object
Error Object
3 properties 2 required
eventTypes_list-event-types_Response_200
object
Service response
2 properties 2 required
AdhocInviteeSpecifiedLocation
object
Information for an Invitee Specified Location
2 properties 1 required
OneOffEventTypesPostRequestBodyContentApplicationJsonSchemaDateSetting
List-event-type-membershipsRequestUnauthorizedError
object
Error Object
3 properties 2 required
AdhocGoogleConference
object
Information for a Google Conference
1 property 1 required
EventTypesPostResponsesContentApplicationJsonSchemaTitle
string
Update-event-typeRequestInternalServerError
object
Error Object
3 properties 2 required
List-event-typesRequestNotFoundError
object
Error Object
3 properties 2 required
EventTypeLocale
string
The locale on the event type, used to determine the language of the event type's scheduling page
AdhocWebExConferenceKind
string
EventTypesGetResponsesContentApplicationJsonSchemaTitle
string
SpotsType
string
DateRange
object
Only allow scheduling within a specified date range
3 properties 3 required
Profile
object
The publicly visible profile of a User or a Team that's associated with the Event Type (note: some Event Types don't have profiles)
3 properties 3 required
EventTypeCustomQuestionType
string
The type of response that the invitee provides to the custom question; can be one or multiple lines of text, a phone number, or single- or multiple-select.
EventTypeType
string
Indicates if the event type is "AdhocEventType" (ad hoc event) or "StandardEventType" (standard event type)
GetEventTypeRequestForbiddenError0
object
Error Object
3 properties 2 required
Create-one-off-event-typeRequestUnauthorizedError
object
Error Object
3 properties 2 required
EventTypeBookingMethod
string
Indicates if the event type is for a poll or an instant booking
AdhocMicrosoftTeamsConference
object
Information for a Microsoft Teams Conference
1 property 1 required
EventTypeMembershipsGetResponsesContentApplicationJsonSchemaOneOf0Title
string
AdhocZoomConferenceKind
string
AdhocInPersonMeetingKind
string
EventTypeMembershipsGetResponsesContentApplicationJsonSchemaTitle
string
EventTypesUuidGetResponsesContentApplicationJsonSchemaOneOf0Title
string
Create-event-typeRequestForbiddenError
DateRangeType
string
LocationConfigurationKind
string
List-event-typesRequestForbiddenError
UserLocale
string
The user's language preference
Create-event-typeRequestInternalServerError
object
Error Object
3 properties 2 required
EventTypesUuidGetResponsesContentApplicationJsonSchemaMessage
string
Get-event-typeRequestInternalServerError
object
Error Object
3 properties 2 required
AdhocOutboundCall
object
Information about an Outbound Call
1 property 1 required
EventTypesUuidPatchRequestBodyContentApplicationJsonSchemaLocale
string
The locale on the event type, used to determine the language of the event type's scheduling page
LocationConfiguration
object
A configuration for an EventType's location
4 properties
eventTypes_create-one-off-event-type_Response_201
object
1 property 1 required
List-event-typesRequestInternalServerError
object
Error Object
3 properties 2 required
OneOffEventsError
object
Permission Denied
3 properties
AdhocWebExConference
object
Information about a WebEx Conference
1 property 1 required
EventTypeKind
string
Indicates if the event type is "solo" (belongs to an individual user) or "group"
List-event-type-available-timesRequestBadRequestError
object
Error Object
3 properties 2 required
EventTypesUuidPatchResponsesContentApplicationJsonSchemaTitle
string
List-event-typesRequestBadRequestError
object
Error Object
3 properties 2 required
EventTypesErrorTitle
string
EventTypesPostResponsesContentApplicationJsonSchemaOneOf0Title
string
eventTypes_create-event-type_Response_201
object
1 property 1 required
CreateEventTypeRequestForbiddenError0
object
Error Object
3 properties 2 required
AdhocGotoMeetingConference
object
Information for a GotoMeeting Conference
1 property 1 required
List-event-typesRequestUnauthorizedError
object
Error Object
3 properties 2 required
AdhocCustomLocation
object
Information for a Custom Location
2 properties 1 required
EventTypeMembershipsGetResponsesContentApplicationJsonSchemaCollectionItems
object
5 properties 2 required
Create-one-off-event-typeRequestNotFoundError
object
Error Object
3 properties 2 required
Create-event-typeRequestNotFoundError
object
Error Object
3 properties 2 required
Get-event-typeRequestForbiddenError
AdhocInPersonMeeting
object
Information for an In Person Meeting
3 properties 1 required
AdhocGotoMeetingConferenceKind
string
AdhocInboundCall
object
Information for an Inbound Call
3 properties 2 required
OneOffEventsErrorTitle
string
EventTypesPostResponsesContentApplicationJsonSchemaMessage
string
List-event-type-available-timesRequestInternalServerError
object
Error Object
3 properties 2 required
Get-event-typeRequestBadRequestError
object
Error Object
3 properties 2 required
List-event-type-membershipsRequestBadRequestError
object
Error Object
3 properties 2 required
ErrorResponseDetailsItem
object
3 properties 1 required
OneOffEventTypesPostRequestBodyContentApplicationJsonSchemaLocation
Update-event-typeRequestUnauthorizedError
object
Error Object
3 properties 2 required
AdhocGoogleConferenceKind
string
InsufficientScopeErrorTitle
string
EventType
object
A configuration for an Event Type
26 properties 26 required
AdhocOutboundCallKind
string
List-event-type-available-timesRequestForbiddenError
EventTypesGetResponsesContentApplicationJsonSchemaMessage
string
AdhocZoomConference
object
Information about a Zoom Conference
1 property 1 required
EventTypesPostRequestBodyContentApplicationJsonSchemaLocale
string
The locale on the event type, used to determine the language of the event type's scheduling page
Update-event-typeRequestForbiddenError
EventTypesPostResponsesContentApplicationJsonSchemaOneOf0Message
string
AdhocInviteeSpecifiedLocationKind
string
EventTypesUuidGetResponsesContentApplicationJsonSchemaTitle
string
UserTimeNotation
string
Time notation used by the user. Accepts "12h" or "24h" as a value.
UpdateEventTypeRequestForbiddenError0
object
Error Object
3 properties 2 required
EventTypeAvailableTimesGetResponsesContentApplicationJsonSchemaOneOf0Title
string
User
object
Information about the user.
13 properties 12 required
Get-event-typeRequestNotFoundError
object
Error Object
3 properties 2 required
InsufficientScopeErrorMessage
string
eventTypes_update-event-type_Response_200
object
1 property 1 required
Update-event-typeRequestNotFoundError
object
Error Object
3 properties 2 required
eventTypes_list-event-type-memberships_Response_200
object
2 properties 2 required
EventTypePoolingType
string
Indicates if the event type is "round robin" (alternates between hosts) or "collective" (invitees pick a time when all participants are available) or “multi-po…
eventTypes_get-event-type_Response_200
object
1 property 1 required
List-event-type-membershipsRequestInternalServerError
object
Error Object
3 properties 2 required
Create-one-off-event-typeRequestBadRequestError
object
Error Object
3 properties 2 required
EventTypeAvailableTime
object
An available meeting time slot for the given event type
4 properties 4 required
Update-event-typeRequestBadRequestError
object
Error Object
3 properties 2 required
OneOffEventsErrorDetailsItems
object
2 properties
List-event-type-membershipsRequestForbiddenError
Create-one-off-event-typeRequestInternalServerError
object
Error Object
3 properties 2 required
AdhocInboundCallKind
string
EventTypesUuidGetResponsesContentApplicationJsonSchemaOneOf0Message
string
EventTypesUuidPatchResponsesContentApplicationJsonSchemaMessage
string
SpotsSpotsItems
object
2 properties 2 required
EventTypeAvailableTimesGetResponsesContentApplicationJsonSchemaTitle
string
Create-one-off-event-typeRequestForbiddenError
Create-event-typeRequestBadRequestError
object
Error Object
3 properties 2 required
Pagination
object
5 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

calendly-eventtypes-api-openapi.yml Raw ↑

Other APIs Calendly publishes across the network.

Calendly Webhook API
Calendly Embed API
Calendly Availability API
Calendly Groups API
Calendly Organizations API
Calendly Shares API
Calendly Users API
Calendly Activity Log API
Calendly Contacts API
Calendly Data Compliance API
Calendly Locations API
Calendly Notetaker API
Where this information came from

This is an independent, third-party profile of Calendly Event Types API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.