Create Appointment (No Reserve)

Overview

This endpoint allows you to immediately create and schedule an appointment in the Tempo system without going through the reservation step.

Endpoint

POST /v1/organizations/{organizationId}/appointments

Headers

Parameter	Type	Required	Description

Parameter	Type	Required	Description
Authorization	string	Yes	Bearer Token (`Bearer YOUR_TOKEN`)
x-api-key	string	Yes	API key for authentication
Content-Type	string	Yes	Must be `application/json`
accept	string	Yes	Expected response format (`application/json`)

Path Variable

Name	Type	Description

Name	Type	Description
organizationId	string	The unique identifier for your organization in Tempo

Request Body

{
  "serviceId": "3fa85f64-5717-4562-b3fc-2c963f66afa7",
  "externalId": "2f1d1856-c908-441a-b362-76f1fbd29da2",
  "locationId": "8f0347a3-cb12-413e-93dd-8c21941016a0",
  "startDateTime": "2024-11-30T12:30:00Z",
  "fields": [
    {
      "internalName": "First Name",
      "values": "John"
    },
    {
      "internalName": "Last Name",
      "values": "Doe"
    },
    {
      "internalName": "Email",
      "values": ["test@qless.com"]
    },
    {
      "internalName": "Phone Number",
      "values": "+14441234567"
    }
  ]
}

Body Parameters

Field Name	Type	Required	Description

Field Name	Type	Required	Description
serviceId	string	Yes	ID of the service to be booked
externalId	string	Yes	Client-specific ID for tracking the appointment
locationId	string	Yes	ID of the location where the appointment will occur
startDateTime	string	Yes	Appointment start date/time in ISO 8601 UTC format
fields	array	No	List of objects with custom fields for the visit

Response

{
  "id": "abc123def456ghi789"
}