Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Calendly Event Types API

Endpoints for listing, retrieving, and managing event types that define the kinds of meetings users can schedule.

Calendly Event Types API is one of 14 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 3 operations across 3 paths, and defines 4 schemas. It is described by OpenAPI 3.1.0, at version 2.0.0.

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

3 operations 3 paths 4 schemas 2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0.0
Base URL
https://api.calendly.com
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Calendly Event Types API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Personal access token or OAuth 2.1 access token. Include in the Authorization header as Bearer {token}.

Paths & Operations 3

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

Event Types 3

Endpoints for listing, retrieving, and managing event types that define the kinds of meetings users can schedule.

GET
/event_types
List event types
listEventTypes 6 params → 200401
GET
/event_types/{uuid}
Get event type
getEventType 1 param → 200401404
POST
/one_off_event_types
Create one-off event type
createOneOffEventType body → 201400401

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are EventType (20 properties), CustomQuestion (8 properties), Pagination (5 properties), Error (3 properties). Each schema is shown below with its type and property counts.

CustomQuestion
object
A custom question displayed on the event type booking page.
8 properties
EventType
object
An event type defines a kind of meeting that can be scheduled, including its duration, location, and availability configuration.
20 properties
Pagination
object
Pagination information for paginated list responses.
5 properties
Error
object
An error response from the Calendly API.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

calendly-event-types-api-openapi.yml Raw ↑

Other APIs Calendly publishes across the network.

Calendly Webhook API
Calendly Embed API
Calendly Activity Log API
Calendly Availability API
Calendly Data Compliance API
Calendly Groups API
Calendly Invitees API
Calendly Organizations API
Calendly Routing Forms API
Calendly Scheduled Events API
Calendly Shares API
Calendly Users API