---
title: "Create group appointment"
method: POST
path: "/group_appointments"
tags: ["Group Appointment"]
---

# Create group appointment

`POST /group_appointments`

## Request body

- object
  - `appointment_type_id` string, int64 — appointment type id
  - `business_id` string, int64 — business id
  - `ends_at` string, date-time — If not provided on create or set to null on update, this will be based on the duration of the appointment type.
  - `max_attendees` integer — If not provided on create, this will be based on the max_attendees of the appointment type.
  - `notes` string, nullable
  - `practitioner_id` string, int64 — practitioner id
  - `starts_at` string, date-time
  - `repeat_rule` object, nullable
    - `number_of_repeats` integer, nullable
    - `repeat_type` 'Daily' | 'Monthly' | 'Weekly', nullable
    - `repeating_interval` integer, nullable

## Response `201`

Resource was created

- GroupAppointment
  - `appointment_type` object
    - `links` object
      - `self` string, uri
  - `archived_at` string, date-time, nullable
  - `attendees` object
    - `links` object
      - `self` string, uri
  - `business` object
    - `links` object
      - `self` string, uri
  - `conflicts` object, nullable
    - `links` object
      - `self` string, uri
  - `created_at` string, date-time
  - `deleted_at` string, date-time, nullable
  - `ends_at` string, date-time
  - `id` string, int64
  - `links` object
    - `self` string, uri
  - `max_attendees` integer
  - `notes` string, nullable
  - `patient_ids` string[], nullable
  - `practitioner` object
    - `links` object
      - `self` string, uri
  - `repeat_rule` object, nullable
    - `number_of_repeats` integer, nullable
    - `repeat_type` 'Daily' | 'Monthly' | 'Weekly', nullable
    - `repeating_interval` integer, nullable
  - `repeated_from` object
    - `links` object
      - `self` string, uri
  - `repeats` object, nullable
    - `links` object
      - `self` string, uri
  - `starts_at` string, date-time
  - `telehealth_url` string, uri, nullable
  - `updated_at` string, date-time

## Other responses

- `422` — Resource could not be saved due to validation errors

---

[API](https://skmtc.net/cliniko/apis/cliniko-api.md) · [All operations](https://skmtc.net/cliniko/apis/cliniko-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cliniko/cliniko-api/versions/c129a555ff44/schema)