---
title: "Creates an appointment group"
method: POST
path: "/appointment_groups"
tags: ["Appointment Groups"]
---

# Creates an appointment group

`POST /appointment_groups`

An appointment group links multiple appointments together so they are treated as a single booking (e.g. multi-pet visits or multi-service parties). Create a group, then attach appointments to it by sending the returned `id` as `appointment_group_id` on the appointment endpoints.

## Headers

- `X-Subdomain` string

## Response `200`

Appointment group response

- object
  - `appointment_group` AppointmentGroup
    - `id` integer — Group id. Pass this value as `appointment_group_id` on the appointment endpoints to attach an appointment to this group.
    - `company_id` integer — Id of the company that owns the group.
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `appointment_group_items` AppointmentGroupItem[] — Join records linking each member appointment to the group. Only returned when the `appointment_group_items` query param is set on `GET /appointment_groups/{id}`.
      - `id` integer — Id of the join record.
      - `appointment_group_id` integer — Id of the parent appointment group.
      - `appointment_id` integer — Id of the grouped appointment. Look up details via `GET /appointments/{id}`.
      - `created_at` string, date-time
      - `updated_at` string, date-time

## Other responses

- `422` — Invalid parameters

---

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