Skip to main content
POST

Authorizations

​
Authorization
string
header
required

Query Parameters

​
expand
string

Comma-separated sub-resources to add to the page, each under its own key: questionSettings, the booking form as GET /event-types/{uuid}/questions returns it, and notificationSettings, the notification settings as GET /event-types/{uuid}/notifications returns them. The list form expand[]=questionSettings&expand[]=notificationSettings is read the same way. Needs a page you may manage, as those endpoints do. Any other name answers 422.

Example:

"questionSettings,notificationSettings"

Body

application/json
​
type
enum<string>
required

ONE_ON_ONE books the page owner. GROUP books the page owner too, and lets up to maxActiveInvitees invitees book the same time slot; it takes one duration and at most one location. ROUND_ROBIN books one of the hosts, COLLECTIVE books every host at once. A group page needs a plan that includes group pages.

Available options:
ONE_ON_ONE,
GROUP,
ROUND_ROBIN,
COLLECTIVE
​
title
string
required
Maximum string length: 100
​
slug
string

The last part of the booking link. Defaults to one made from the title. A round robin or collective page without teamId always gets a generated slug.

​
description
string | null

HTML shown on the booking page, up to 4000 visible characters.

​
language
enum<string>

The language of the booking page and of the emails its invitees get: en English, de German addressing the invitee formally (Sie), de-du German addressing the invitee informally (du), nl Dutch, fi Finnish, es Spanish, fr French, pl Polish, da Danish, sv Swedish, it Italian. Defaults to your own language. Any other value answers 422.

Available options:
en,
de,
de-du,
nl,
fi,
es,
fr,
pl,
da,
sv,
it
​
eventDurations
object[]

Defaults to one 30-minute duration.

Required array length: 1 - 5 elements
​
locations
object[]
Maximum array length: 10
​
teamId
string

The team that owns the page, by its id or slug. A team outside your workspace answers 422. Without it a one-on-one page belongs to you, and a round robin or collective page is shared across the workspace.

​
hosts
object[]

Round robin and collective only, and required unless allMembersIn is true. With teamId every host must be a member of that team.

Minimum array length: 1
​
allMembersIn
boolean

Round robin and collective pages of a team only. Every team member is a host, now and as the team changes.

​
maxActiveInvitees
integer

How many invitees one time slot takes. Required for a group page, which takes 2 or more. On a round robin page more than 1 lets several invitees book the same slot with the same host; defaults to 1. Other types ignore it.

Required range: 1 <= x <= 1000
​
isActive
boolean

Defaults to true. When your plan allows no more active one-on-one or group pages, the page is created inactive and the response reads isActive false.

​
questionSettings
object

The booking form, in the body PUT /event-types/{uuid}/questions takes. Every question is new, so none carries an id. Replaces the two default questions a new page starts with; without it the page keeps them. A refusal is keyed under this name, for example questionSettings.questions.0.label.

​
notificationSettings
object

The notification settings, in the body PATCH /event-types/{uuid}/notifications takes; a setting left out keeps the default a new page gets. A refusal is keyed under this name, for example notificationSettings.customNotifications.inviteeConfirmation.body.

Response

Created. The body is the page as GET /event-types/{uuid} returns it.

​
resource
object
required

A scheduling page (event type) with full details, as returned when fetching a single scheduling page. Extends the list shape with hosts, notifications, and Flexi configuration.

Last modified on November 1, 2026