The event type atom enables a user to create events that others can use to book them. The events can be created for an individual or a team. However, a team event type can only be created by a team admin or owner.

​
Individual event type

Below code snippet can be used to render the create event type atom, which is a form with all the required input fields needed to create an event type.

import { CreateEventType } from "@calcom/atoms";

export default function EventType() {
  return (
    <>
      <CreateEventType
        onSuccess={(eventType) => {
          console.log("EventType created successfully", eventType);
        }}
        customClassNames={{
          atomsWrapper: "border p-4 rounded-md",
          buttons: { submit: "bg-red-500", cancel: "bg-gray-300" },
        }}
      />
    </>
  )
}

For a demonstration of the create event type atom, please refer to the video below.

​
Team event type

For creating an event type for a team, you need to provide the team id of your particular team as a prop to the create event type atom. Importantly, a team event type can only be created by a managed user who has an accepted admin or owner role within the team. That means you have to create a managed user and then add an accepted membership with an admin or owner role by making a request to the memberships endpoint. Example body:

{
  "userId": 1006,
  "accepted": true,
  "role": "OWNER"
}

then you have to pass the access token of this managed user to the CalProvider to then finally be able to use the <CreateEventType /> component while passing teamId={teamId} to it to create a team event type:

import { CreateEventType } from "@calcom/atoms";

export default function TeamEventType(teamId: number) {l
  return (
    <>
      <CreateEventType
        teamId={teamId}
        onSuccess={(eventType) => {
          console.log("EventType created successfully", eventType);
        }}
        customClassNames={{
          atomsWrapper: "border p-4 rounded-md",
          buttons: { submit: "bg-red-500", cancel: "bg-gray-300" },
        }}
      />
    </>
  )
}

For a demonstration of the create event type atom, please refer to the video below.

Below is a list of props that can be passed to the create event type atom

NameRequiredDescription
teamIdNoUnique identifier of the team
customClassNamesNoTo pass in custom classnames from outside for styling the atom
onSuccessNoCallback function that handles successful creation of event type
onErrorNoCallback function to handles errors at the time of event type creation
onCancelNoCallback function that handles cancellation of event type form

Along with the props, create event type atom accepts custom styles via the customClassNames prop. Below is a list of props that fall under this customClassNames prop.

NameDescription
atomsWrapperAdds styling to the whole create event type atom
buttonsObject containing classnames for the submit and cancel buttons inside the create event type atom
Individual and team event types take in the same props.

​
Event type settings

The event type settings contains various tabs that can be used to configure or make modifications to the event type that has just been created.

Below code snippet can be used to render the event type settings atom.

import { EventTypeSettings } from "@calcom/atoms";

export function EventTypeTabs(eventTypeId: number) {
  return (
    <>
      <EventTypeSettings
        id={eventTypeId}
        allowDelete={true}
        onSuccess={(eventType) => {
          console.log("EventType settings updated successfully", eventType);
        }}
        onFormStateChange={(formState) => {
          console.log("Form state changed:", formState);
          // Access form data: formState.isDirty, formState.dirtyFields, formState.values
        }}
        customClassNames={{ atomsWrapper: "!w-[70vw] !m-auto" }}
      />
    </>
  );
}

If the eventTypeId is of a team event type id, then only the owner or admin of the team can update the event type settings. That means you have to create a managed user and then add an accepted membership with an admin or owner role by making a request to the memberships endpoint. Example body:

{
  "userId": 1006,
  "accepted": true,
  "role": "OWNER"
}

then you have to pass the access token of this managed user to the CalProvider to then finally be able to use the <EventTypeSettings /> component while passing id of a team event type enabling admin or owner to edit team event types.

For a demonstration of the event type settings atom, please refer to the video below.

Below is a list of props that can be passed to the event type settings atom.

NameRequiredDescription
idYesThe event type id obtained at the time of event type creation
tabsNoThe tabs you want the event type settings to display
onSuccessNoCallback function that triggers when the event type is successfully updated
onErrorNoCallback function to handles errors at the time of event type update
onFormStateChangeNoCallback function that triggers when the form state changes, providing access to isDirty, dirtyFields, and current form values
onDeleteSuccessNoCallback function that triggers when the event type is successfully deleted
onDeleteErrorNoCallback function that handles errors at the time of event type deletion
allowDeleteNoBoolean value that determines whether the delete button is displayed or not
disableToastsNoBoolean value that determines whether the toasts are displayed or not
customClassNamesNoTo pass in custom classnames from outside for styling the atom

Along with the props, event type settings atom accepts custom styles via the customClassNames prop. Below is a list of props that fall under this customClassNames prop.

NameDescription
atomsWrapperAdds styling to the whole event type settings atom

Please ensure all custom classnames are valid Tailwind CSS classnames.

Following are the tabs that are available in the event type settings atom:

1. Event Setup

The event setup tab allows users to configure the fundamental aspects of their events. In this tab, users can define or update essential details such as the event title, description, duration, slug, location as well as the event URL.

2. Availability

The availability tab allows users to manage their scheduling preferences effectively. Within this tab, users can edit their existing availability or set new availability options based on the preferences they have previously established.

For team event types, availability for a specific event can also be configured for the entire team based on a common schedule. Otherwise each host can be assigned their own specific availability based on their schedules.

3. Assignment

The assignment tab is only available for team event types. It lets you configure what kind of scheduling you want to enable for your team event, where you can choose from a collective, round robin or managed event. You can also choose who amongst your team can or cannot attend the event.

4. Limits

The limits tab lets you configure how often you can be booked. You can add a lot of configurations via this tab, such as a buffer time before or after the event and a minimum notice period.

Also if you want to select how many time a particular event can be booked, or how far in the future the event can be booked that is also possible. Or if you want to limit the event to a specific amount of time, that can also be done via the limits tab.

Below video shows a demonstration of the limits tab.

5. Advanced

The advanced tab lets you customize your event type with a lot more options. For example, you can set a custom name for the event type that will appear in your calendar, or add questions that will appear on your booking page. Another option would be to add an email verification for the person who is booking the event.

Below video shows a demonstration of the all the options you get in the advanced tab.

6. Recurring

The recurring tab lets you set up a recurring event. You can set up recurring events such as weekly, monthly, yearly, etc for a maximum of events you want it to repeat.

Recurring events are currently experimental and causes some issues sometimes when checking for availability. We are working on fixing this.

7. Payments

The payments tab lets you accept payments for your events. At the moment we only support payments via Stripe.

Once you connect your Stripe account, you can set a custom price along with the currency and payment option; which will determine when to charge your customers.