Documented steps

Obtain an API key from Cal.com Settings > Security (prefix cal_ for test mode, cal_live_ for live mode), or an OAuth/managed-user access token with the EVENT_TYPE_WRITE scope.
Set header Authorization: 'Bearer <TOKEN>' — this endpoint requires authentication.
Set header cal-api-version: 2024-06-14 exactly; a missing or different value selects an older, incompatible version of this endpoint.
Set header Content-Type: application/json.
Send POST https://api.cal.com/v2/event-types with a JSON body containing the required fields title=<string>, slug=<URL-friendly string>, and lengthInMinutes=<number, minimum 1>.
Optionally add bookingFields, locations, scheduling limits (bookingLimitsCount, bookingLimitsDuration), confirmationPolicy, recurrence, seats, or calVideoSettings in the same body.
Expect HTTP 201 with {status:'success', data:{id, lengthInMinutes, title, slug, ...}} including the booking URL.
Store the returned data.id — it is the eventTypeId needed by /v2/slots, /v2/slots/reservations, and later GET/PATCH calls.
If using OAuth, confirm the token carries EVENT_TYPE_WRITE before calling; a missing scope returns 403.
Ensure slug is unique for the user/team — check GET /v2/event-types first if uniqueness is not guaranteed.
Docs: https://cal.com/docs/api-reference/v2/event-types/create-an-event-type

Known gotchas

cal-api-version for event-types is 2024-06-14 — a different value than the 2024-09-04 used by slots endpoints; mixing them silently changes the response schema.
The v1 field name 'length' was renamed to lengthInMinutes in v2; sending 'length' does not set the duration.
OAuth callers without EVENT_TYPE_WRITE get a 403 even with an otherwise valid token.
Duplicate slug for the same user/team returns a 4xx error.
Cal.com's 'Platform' authentication approach is documented as deprecated as of December 15, 2025 — build new integrations on API-key or the current OAuth flow.

developer.calendly.com · 5 steps · unrated

Create and manage events and ticket types via the Ticket Tailor API

tickettailor.com · 5 steps · unrated

Create a Cal.com event type via API v2 with locations and booking limits

cal.com · 6 steps · unrated

Give your agent this knowledge — and 16,400+ more routes

One MCP install gives any agent live access to the full route map across 5,800+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Create a new event type in Cal.com via API v2 POST /v2/event-types, specifying title, slug, and lengthInMinutes with the correct version header.

Documented steps

Known gotchas

Related routes

Give your agent this knowledge — and 16,400+ more routes

Need this verified for your stack — or a route we don't have yet?