Skip to main content
POST
Create or safely replay an appointment

Path Parameters

accountId
integer
required

HueChat account ID

Body

application/json

Appointment

contact_id
integer
Example:

42

customer_email
string
Example:

"customer@example.com"

customer_name
string
Example:

"Example Customer"

customer_phone
string
Example:

"+966500000000"

date
string
Example:

"2026-09-15"

deal_id
string<uuid>
Example:

"00000000-0000-4000-8000-000000000003"

ends_at
string
Example:

"2026-09-15T09:30:00Z"

external_id
string
Required string length: 1 - 128
Example:

"erp-appointment-10492"

notes
string
Example:

"Created from ERP"

resource_id
string
Example:

"00000000-0000-4000-8000-000000000001"

resource_name
string
Example:

"Dr. Sara"

service_id
string
Example:

"00000000-0000-4000-8000-000000000002"

service_name
string
Example:

"Initial consultation"

starts_at
string
Example:

"2026-09-15T09:00:00Z"

status
enum<string>
Available options:
tentative,
booked,
confirmed
Example:

"booked"

time
string
Example:

"12:00"

Response

OK

account_id
integer
buffer_after_minutes
integer
buffer_before_minutes
integer
busy_ends_at
string<date-time>
busy_starts_at
string<date-time>
cancellation_reason
string
cancelled_at
string<date-time>
completed_at
string<date-time>
confirmed_at
string<date-time>
contact_id
integer
conversation_id
integer
created_at
string<date-time>
created_by_ai_agent_id
string<uuid>
created_by_user_id
integer
customer_email
string
customer_name
string
customer_phone
string
duration_minutes
integer
ends_at
string<date-time>
external_id
string
id
string<uuid>
notes
string
public_id
string
resource_color
string
resource_id
string<uuid>
resource_name
string
resource_type
string
service_color
string
service_currency
string
service_description
string
service_id
string<uuid>
service_name
string
service_price
number
source
string
starts_at
string<date-time>
status
string
updated_at
string<date-time>
version
integer