> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Get team event type

> Retrieves one team-owned Cal.com event type.

`calcom.getTeamEventType` retrieves one team-owned Cal.com event type.

```ts automations/get-team-event-type.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { calcom } from "automate.ax/calcom"

export default automation("Get team event type", () => {
  markSignificant(calcom.getTeamEventType({ teamId: 17, eventTypeId: 23 }))
})
```

## Input

Pass these fields:

| Field         | Type      | Required | Description             |
| ------------- | --------- | -------- | ----------------------- |
| `teamId`      | `integer` | Yes      | Must be greater than 0. |
| `eventTypeId` | `integer` | Yes      | Must be greater than 0. |

## Output

Returns an object with these fields:

| Field                                  | Type                                                | Required | Description                                                                                                                                                                                                       |
| -------------------------------------- | --------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                                   | `number`                                            | Yes      | —                                                                                                                                                                                                                 |
| `lengthInMinutes`                      | `number`                                            | Yes      | —                                                                                                                                                                                                                 |
| `lengthInMinutesOptions`               | `number[]`                                          | No       | If you want that user can choose between different lengths of the event you can specify them here. Must include the provided `lengthInMinutes`.                                                                   |
| `title`                                | `string`                                            | Yes      | —                                                                                                                                                                                                                 |
| `slug`                                 | `string`                                            | Yes      | —                                                                                                                                                                                                                 |
| `description`                          | `string`                                            | Yes      | —                                                                                                                                                                                                                 |
| `locations`                            | `object[]`                                          | Yes      | —                                                                                                                                                                                                                 |
| `bookingFields`                        | `object[]`                                          | Yes      | —                                                                                                                                                                                                                 |
| `disableGuests`                        | `boolean`                                           | Yes      | —                                                                                                                                                                                                                 |
| `slotInterval`                         | `number \| null`                                    | No       | —                                                                                                                                                                                                                 |
| `minimumBookingNotice`                 | `number`                                            | No       | —                                                                                                                                                                                                                 |
| `beforeEventBuffer`                    | `number`                                            | No       | —                                                                                                                                                                                                                 |
| `afterEventBuffer`                     | `number`                                            | No       | —                                                                                                                                                                                                                 |
| `recurrence`                           | `object \| null`                                    | Yes      | —                                                                                                                                                                                                                 |
| `metadata`                             | `object`                                            | Yes      | —                                                                                                                                                                                                                 |
| `price`                                | `number`                                            | Yes      | —                                                                                                                                                                                                                 |
| `currency`                             | `string`                                            | Yes      | —                                                                                                                                                                                                                 |
| `lockTimeZoneToggleOnBookingPage`      | `boolean`                                           | Yes      | —                                                                                                                                                                                                                 |
| `seatsPerTimeSlot`                     | `number \| null`                                    | No       | —                                                                                                                                                                                                                 |
| `forwardParamsSuccessRedirect`         | `boolean \| null`                                   | Yes      | —                                                                                                                                                                                                                 |
| `successRedirectUrl`                   | `string \| null`                                    | Yes      | —                                                                                                                                                                                                                 |
| `isInstantEvent`                       | `boolean`                                           | Yes      | —                                                                                                                                                                                                                 |
| `seatsShowAvailabilityCount`           | `boolean \| null`                                   | No       | —                                                                                                                                                                                                                 |
| `scheduleId`                           | `number \| null`                                    | Yes      | —                                                                                                                                                                                                                 |
| `bookingLimitsCount`                   | `object`                                            | No       | —                                                                                                                                                                                                                 |
| `bookerActiveBookingsLimit`            | `object`                                            | No       | —                                                                                                                                                                                                                 |
| `onlyShowFirstAvailableSlot`           | `boolean`                                           | No       | —                                                                                                                                                                                                                 |
| `bookingLimitsDuration`                | `object`                                            | No       | —                                                                                                                                                                                                                 |
| `bookingWindow`                        | `object[] \| object`                                | No       | Configured booking windows, or `{ disabled: boolean }` when the setting is disabled.                                                                                                                              |
| `bookerLayouts`                        | `object`                                            | No       | —                                                                                                                                                                                                                 |
| `confirmationPolicy`                   | `object`                                            | No       | —                                                                                                                                                                                                                 |
| `bookingProposalCount`                 | `number \| null`                                    | No       | —                                                                                                                                                                                                                 |
| `requiresBookerEmailVerification`      | `boolean`                                           | No       | —                                                                                                                                                                                                                 |
| `skipAttendeeEmailDeliverabilityCheck` | `boolean`                                           | No       | When true, skips the MX deliverability check for attendee emails. Format validation and watchlist still apply. Available only to organizations, including platform organizations.                                 |
| `emailSettings`                        | `JSON value`                                        | No       | Email settings for this event type. Personal event types require an accepted organization membership; team event types require an organization team. This does not include emails sent by custom email workflows. |
| `hideCalendarNotes`                    | `boolean`                                           | No       | —                                                                                                                                                                                                                 |
| `color`                                | `object`                                            | No       | —                                                                                                                                                                                                                 |
| `seats`                                | `object`                                            | No       | —                                                                                                                                                                                                                 |
| `offsetStart`                          | `number`                                            | No       | —                                                                                                                                                                                                                 |
| `customName`                           | `string`                                            | No       | —                                                                                                                                                                                                                 |
| `destinationCalendar`                  | `object`                                            | No       | —                                                                                                                                                                                                                 |
| `useDestinationCalendarEmail`          | `boolean`                                           | No       | —                                                                                                                                                                                                                 |
| `hideCalendarEventDetails`             | `boolean`                                           | No       | —                                                                                                                                                                                                                 |
| `hideOrganizerEmail`                   | `boolean`                                           | No       | Boolean to Hide organizer's email address from the booking screen, email notifications, and calendar events                                                                                                       |
| `calVideoSettings`                     | `JSON value`                                        | No       | Cal video settings for the event type                                                                                                                                                                             |
| `hidden`                               | `boolean`                                           | Yes      | —                                                                                                                                                                                                                 |
| `bookingRequiresAuthentication`        | `boolean`                                           | Yes      | Whether booking this event type through the API requires authentication. When true, only the event-type owner or an organization or team administrator or owner can book it.                                      |
| `disableCancelling`                    | `JSON value`                                        | No       | Settings for disabling cancelling of this event type.                                                                                                                                                             |
| `disableRescheduling`                  | `JSON value`                                        | No       | Settings for disabling rescheduling of this event type. Can be always disabled or disabled when less than X minutes before the meeting.                                                                           |
| `interfaceLanguage`                    | `string \| null`                                    | No       | —                                                                                                                                                                                                                 |
| `allowReschedulingPastBookings`        | `boolean`                                           | No       | Enabling this option allows for past events to be rescheduled.                                                                                                                                                    |
| `allowReschedulingCancelledBookings`   | `boolean \| null`                                   | No       | —                                                                                                                                                                                                                 |
| `showOptimizedSlots`                   | `boolean \| null`                                   | No       | —                                                                                                                                                                                                                 |
| `privateNoteEnabled`                   | `boolean`                                           | No       | When enabled, a private note calendar event is created alongside the booking with the resolved template as its description. Only visible to the host.                                                             |
| `privateNoteMode`                      | `JSON value`                                        | No       | —                                                                                                                                                                                                                 |
| `privateNoteTemplate`                  | `string \| null`                                    | No       | —                                                                                                                                                                                                                 |
| `teamId`                               | `number`                                            | Yes      | —                                                                                                                                                                                                                 |
| `bookingUrl`                           | `string (uri) \| null`                              | Yes      | —                                                                                                                                                                                                                 |
| `ownerId`                              | `number \| null`                                    | No       | —                                                                                                                                                                                                                 |
| `parentEventTypeId`                    | `number \| null`                                    | No       | —                                                                                                                                                                                                                 |
| `hosts`                                | `object[]`                                          | Yes      | —                                                                                                                                                                                                                 |
| `assignAllTeamMembers`                 | `boolean`                                           | No       | —                                                                                                                                                                                                                 |
| `schedulingType`                       | `"roundRobin" \| "collective" \| "managed" \| null` | Yes      | —                                                                                                                                                                                                                 |
| `team`                                 | `object`                                            | Yes      | —                                                                                                                                                                                                                 |
| `rescheduleWithSameRoundRobinHost`     | `boolean`                                           | No       | Rescheduled events will be assigned to the same host as initially scheduled.                                                                                                                                      |
| `allowRRHostChoiceOnReschedule`        | `boolean`                                           | No       | Let the person rescheduling choose between keeping the original host and letting round robin pick from the whole team.                                                                                            |

Cal.com enforces account role, plan, and availability requirements. Provider rejections surface as structured action failures with the HTTP status and any `Retry-After` delay.
