Skip to content
HeyX API

Create Appointment

Required scope: appointment:create

This endpoint supports active round-robin and choose-user agendas. Agenda, appointment-type, member, and available-slot IDs are configured and discovered in HeyX. For choose-user agendas, assigneeMemberId is required. Omitting it on a round-robin agenda lets HeyX select an eligible member.

Generated Reference
POST /public-api/publicapi.v1.Appointment/CreateAppointment

Creates a direct appointment on a round-robin or choose-user agenda. This operation is not idempotent and must not be blindly retried.

Request CreateAppointmentRequest
Response CreateAppointmentResponse

CreateAppointmentRequest

Field Type Description
portfolio_id string
agenda_id string
appointment_type_id string
scheduled_start_at int64
duration_minutes int32 Zero uses the appointment type default.
notes string
assignee_member_id optional string Required by choose-user agendas; optional for round-robin agendas.

CreateAppointmentResponse

Field Type
appointment Appointment

Related Types

Appointment

Field Type
id string
portfolio_id string
agenda_id string
appointment_type_id string
assigned_member_id string
scheduled_start_at int64
scheduled_end_at int64
duration_minutes int32
status AppointmentStatus
notes string
created_at int64
updated_at int64 
{
  "portfolioId": "<portfolio-id>",
  "agendaId": "<agenda-id>",
  "appointmentTypeId": "<appointment-type-id>",
  "scheduledStartAt": "1788260400",
  "durationMinutes": 60,
  "notes": "Customer confirmed access",
  "assigneeMemberId": "<member-id>"
}

This operation is not idempotent. Check slot availability and do not blindly retry after a timeout.

HeyX API