Skip to content

docs: update create event guide for unified create dialog #147

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: update create event guide for unified create dialog #147

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 23 additions & 8 deletions event-types/create-first-event.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,17 +17,32 @@ A quick walkthrough of how to create event types.

## The basics

Head over to the **event types** page, then click the **New event type** button in the top right.
Head over to the **Event types** page, then click the **New** button in the top right. The same dialog is used to create both personal and team event types, so you can pick where the event lives in one place.

You'll now be presented with the create event type dialog, which prompts you to enter in the basic information needed to get a working event type set up:
You'll be prompted to enter the basic information needed to get a working event type set up:

- Title
- URL (e.g. cal.com/bailey/**example-event**)
- Description
- Length
- **Title**
- **URL** (e.g. `cal.com/bailey/example-event`)
- **Description**
- **Length** (in minutes)

[![](https://downloads.intercomcdn.com/i/o/1195433173/459d590315726cde2c3da6a6/i973x933-2xQuLlTcg2xz_cvs7li.png?expires=1736301600&signature=cb4a1bc917705b98367e3e8b391fcde42d13240eeb044c61f2d3805509eec0e5&req=dSEuE819noBYWvMW1HO4zdvMofsCtCGMAPo%2BOL%2BAzF%2B0SWwGv6se8fklfFKd%0ARDLOujK%2Boq3LGcxdQ5Q%3D%0A)](https://downloads.intercomcdn.com/i/o/1195433173/459d590315726cde2c3da6a6/i973x933-2xQuLlTcg2xz_cvs7li.png?expires=1736301600&signature=cb4a1bc917705b98367e3e8b391fcde42d13240eeb044c61f2d3805509eec0e5&req=dSEuE819noBYWvMW1HO4zdvMofsCtCGMAPo%2BOL%2BAzF%2B0SWwGv6se8fklfFKd%0ARDLOujK%2Boq3LGcxdQ5Q%3D%0A)

New event type dialog

This is all you need to get an event type up and running, but you can configure additional settings for greater control.

## Choose an assignment

The create dialog includes an **Assignment** section with four options that determine who the event belongs to and how bookings are routed:

- **For myself** — Creates the event on your personal profile. Use this for one-on-one meetings booked directly with you.
- **Collective** — Books one slot that all selected team members attend together. Best for panels, demos, or interviews where everyone needs to be present.
- **Round Robin** — Rotates bookings between team members so the workload is shared. Best for sales calls, support, or any team where any member can take the meeting.
- **Managed** — Creates a single event template that team admins can distribute to members in bulk. Best for keeping settings consistent across a team.

The URL preview at the top of the dialog updates automatically as you switch between options, so you can see exactly where the event will live before you save.

<Note>
Collective, Round Robin, and Managed assignments require a team. If you're not on a team yet, those options show an **Upgrade** badge — clicking it opens the upgrade flow so you can create a team first.
</Note>

For a deeper look at each team assignment, see [Collective events](/event-types/collective-events), [Round robin](/event-types/round-robin), and [Managed events](/event-types/managed-events).