---
title: "Create a bookable event type"
method: POST
path: "/appointments/event-types"
tags: ["Appointments"]
---

# Create a bookable event type

`POST /appointments/event-types`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/appointments/event-types`
- Auth: HTTP bearer

Create a new event type. Reuses ``EventTypesHandler.handle_create``
verbatim (slug uniqueness, host wiring, schedule attach), so the result is
identical to creating one in the app. ``slug`` must be unique within the org
(409 on collision); ``length`` is the meeting duration in minutes.

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Request body

- CreateEventTypeRequest
  - `title` string, required
  - `slug` string, required
  - `length` integer, required
  - `description` string, nullable
  - `locations` object[], nullable
  - `booking_fields` object[], nullable
  - `scheduling_type` string, nullable
  - `schedule_id` integer, nullable
  - `time_zone` string, nullable
  - `hidden` boolean
  - `requires_confirmation` boolean
  - `minimum_booking_notice` integer
  - `before_event_buffer` integer
  - `after_event_buffer` integer
  - `slot_interval` integer, nullable
  - `seats_per_time_slot` integer, nullable
  - `disable_guests` boolean
  - `disable_cancelling` boolean
  - `disable_rescheduling` boolean
  - `recurring_event` object, nullable
  - `period_type` string
  - `period_start_date` string, nullable
  - `period_end_date` string, nullable
  - `period_days` integer, nullable
  - `success_redirect_url` string, nullable
  - `event_color` string, nullable
  - `event_name` string, nullable
  - `layouts` string[], nullable
  - `default_layout` string, nullable
  - `metadata` object, nullable
  - `initial_hosts` object[], nullable
  - `use_common_schedule` boolean, nullable

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/graph8/apis/graph8-developer-api.md) · [All operations](https://skmtc.dev/graph8/apis/graph8-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/graph8/apis/graph8-developer-api/revisions/2e7cfa0ca921?raw)