---
title: "Create an Appointment"
method: POST
path: "/appointments"
tags: ["appointments"]
---

# Create an Appointment

`POST /appointments`

Create a new appointment.

## Query parameters

- `mock` boolean

## Request body

- AppointmentPost — Request body for an appointment
  - `data` AppointmentPostData — Data object expected to create an appointment
    - `type` string — Type of resource
    - `attributes` object — Attributes of an appointment resource
      - `organizationId` string, uuid, required — UUID of the organization to which this appointment belongs
      - `organizationAppointmentId` string — The organization's internally identifiable ID of the appointment
      - `scheduledStartDateTime` string, date-time, required — Scheduled appointment start dateTime
      - `scheduledEndDateTime` string, date-time, required — Scheduled appointment end dateTime
      - `actualStartDateTime` string, date-time — Actual appointment start dateTime
      - `actualEndDateTime` string, date-time — Actual appointment end dateTime
      - `answers` object[] — Customer's answers to questions associated with the appointment
      - `resources` object[], required — Types and UUIDs of the appointment resources
        - `type` 'locations' | 'users' | 'customers' | 'services' — Type of resource
        - `id` string, uuid — UUID of resource
      - `status` 'occurred' | 'requested' | 'confirmed' | 'canceled' | 'checkedIn' | 'noShow', required — Appointment status
      - `customerMessage` string — A customer message containing any comments about the appointment

## Response `201`

Return a single data response

- object
  - `data` AppointmentDataResponse, required — Expected data response object for an appointment
    - `type` string — Type of resource
    - `id` string, uuid — UUID of resource; additional resource attributes will also be returned
    - `attributes` object — Attributes of resource
      - `organizationAppointmentId` string — Internally identifiable organization's ID for the appointment
      - `createdAt` string, date-time — Appointment creation Date
      - `updatedAt` string, date-time — Appointment last updated Date
      - `scheduledStartDateTime` string, date-time — Scheduled appointment start dateTime
      - `scheduledEndDateTime` string, date-time — Scheduled appointment end dateTime
      - `actualStartDateTime` string, date-time — Actual appointment start dateTime
      - `actualEndDateTime` string, date-time — Actual appointment end dateTime
      - `status` 'occurred' | 'requested' | 'confirmed' | 'canceled' | 'checkedIn' | 'noShow' — Appointment status
      - `customerMessage` string — A customer message containing any comments about the appointment
      - `updatedBy` union — The UUID of the user that most recently updated the appointment
        - string, uuid
        - unknown
      - `createdBy` string, uuid — The UUID of the user that created the appointment
    - `relationships` AppointmentRelationships — Relationships of an appointment
      - `organization` OrganizationRelationship — Organization that the resource belongs to
        - `data` object
          - `type` string — Type of the organization
          - `id` string, uuid — UUID of the organization
      - `resources` object
        - `data` object[] — Types and UUIDs of the appointment resources
          - `type` 'locations' | 'users' | 'customers' | 'services' — Type of resource
          - `id` string, uuid — UUID of resource
      - `answers` object
        - `data` object[] — Customer's answers to questions associated with the appointment
          - `type` string — Type of the answer
          - `id` string, uuid — UUID of the answer
    - `links` Link — Link object for resource meta data
      - `self` string
  - `links` Link — Link object for resource meta data
    - `self` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/brickworksoftware/apis/brickwork-software-api.md) · [All operations](https://skmtc.dev/brickworksoftware/apis/brickwork-software-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brickworksoftware/brickwork-software-api/revisions/b06aa4f3b83c/schema)