Skip to main content
POST

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

Dealership-Id
string<uuid>
required

Body

application/json
services
object[]
required

Unique Spark service selections with optional write-only comments

Minimum array length: 1
appointmentAt
string<date-time>
required

Chosen appointment instant; must include Z or an explicit offset

Example:

"2026-11-02T09:00:00-05:00"

departmentId
string

An opaque department ID from department discovery

customer
object

Required during discovery only when the scheduler needs customer identity

vehicle
object

Supply vehicle details or select a saved vehicle

advisorId
string

Advisor ID returned by discovery, or any

transportId
string

Transport ID returned by discovery

customerId
string<uuid>
vehicleId
string<uuid>
comments
string

Appointment-level public comments

Response

id
string<uuid>
required
dealership
object
required
status
enum<string>
required
Available options:
Pending,
Canceled,
Showed,
Missed,
Duplicate,
Completed,
Sold
appointmentAt
string<date-time>
required
timezone
string
required
customer
object
required
vehicle
object
required
department
object | null
required
advisor
object
required
transport
object
required
comments
string | null
required
services
object[]
required