Skip to main content
POST
Create an event type

Authorizations

X-Api-Key
string
header
required

API key (hr_live_... or hr_test_...). Generate from Settings › Workspace › Acceso API.

Body

application/json
ownerAgentUserId
string<uuid>
required

UUID of the agent (user) who owns this event type.

name
string
required

Display name for the event type.

Example:

"Property Tour"

slug
string
required

URL-friendly identifier (lowercase letters, numbers and hyphens).

Example:

"property-tour"

durationMin
integer
required

Duration in minutes.

Required range: 5 <= x <= 1440
Example:

30

locationMode
enum<string>
required

Meeting location mode.

Available options:
onsite,
call,
video
Example:

"onsite"

agendaId
string<uuid>

Existing agenda UUID. If omitted, a new agenda will be created.

description
string

Public description shown on the booking page.

bufferBeforeMin
integer
default:0

Buffer time before the meeting (minutes).

Required range: x >= 0
bufferAfterMin
integer
default:0

Buffer time after the meeting (minutes).

Required range: x >= 0
locationDetails
object

Location details object (format depends on locationMode).

color
string

Hex color for calendar display.

Example:

"#3b82f6"

visibility
enum<string>
default:agent_private
Available options:
agent_private,
workspace_template
isActive
boolean
default:true
config
object

Event type config bundle (questions, reminders, confirmation settings).

availabilityConfig
object

Availability schedule for this event type.

Response

201 - undefined