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) {
  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.

​
Programmatic Form Validation and Submission

The EventTypeSettings component supports programmatic form validation and submission through a ref-based API. This allows you to validate form data and submit forms programmatically without user interaction. 
import { useRef } from 'react';
import { EventTypeSettings } from "@calcom/atoms";
import type { EventTypePlatformWrapperRef } from "@calcom/atoms";

export function EventTypeWithValidation(eventTypeId: number) {
  const eventTypeRef = useRef<EventTypePlatformWrapperRef>(null);

  const handleValidate = async () => {
    const result = await eventTypeRef.current?.validateForm();
    if (result?.isValid) {
      console.log("Form is valid");
    } else {
      console.log("Validation errors:", result?.errors);
    }
  };

  const handleSubmit = () => {
    eventTypeRef.current?.handleFormSubmit({
      onSuccess: () => {
        // Additional success handling logic here
        console.log('Event type updated successfully');
      },
      onError: (error) => {
        // Additional error handling logic here
        console.error('Error updating event type:', error);
      }
    });
  };

  return (
    <>
      <EventTypeSettings
        ref={eventTypeRef}
        id={eventTypeId}
        onSuccess={(eventType) => {
          console.log("EventType updated successfully", eventType);
        }}
      />
      <button onClick={handleValidate}>Validate Form</button>
      <button onClick={handleSubmit}>Submit Form</button>
    </>
  );
}

​
Ref Methods

MethodDescription
validateFormValidates the current event type form state and returns a promise with validation results.
handleFormSubmitProgrammatically submits the event type form, triggering the same validation and submission flow as clicking the save button. Unlike validateForm, this method will check required fields and prevent submission unless all required fields are set

​
Callbacks

The handleFormSubmit method accepts an optional callbacks object with the following properties: 
type EventTypeFormCallbacks = {
  onSuccess?: () => void;
  onError?: (error: Error) => void;
};
  • onSuccess: Called when the form submission is successful. This allows you to execute additional logic after a successful update.
  • onError: Called when an error occurs during form submission. The error parameter contains details about what went wrong, allowing you to handle specific error cases or display custom error messages.
The validateForm method returns an EventTypeFormValidationResult object with:
  • isValid: Boolean indicating if the form passed validation
  • errors: Object containing any validation errors found
Note: If a required field is not filled in, the validateForm method will not return any error. The validation focuses on the format and consistency of provided data rather than enforcing required field completion. 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. Event Setup tab 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. User availability 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. Team availability 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. Assignment tab 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 tab
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. Payments tab without stripe connected 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. Payments tab with stripe connected