Event Type

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

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.

​

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.

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.

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.

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.