---
title: "Save Visit Appointments"
method: POST
path: "/locations/{location_id}/attendance/appointments"
tags: ["Appointments"]
---

# Save Visit Appointments

`POST /locations/{location_id}/attendance/appointments`

## Request

- Base URL: `https://api.alteg.io/api/v2`
- URL: `https://api.alteg.io/api/v2/locations/{location_id}/attendance/appointments`
- Auth: HTTP bearer

Save one or more Appointments of one visit together with their Service
lines and Product Items. The web app calls this operation when a Business
User clicks **Save** in the appointment window.

> **This is a replace operation.** Each object in `records` replaces the
> whole Appointment it identifies: date, Team Member, duration, resources,
> Tags, color, comment, walk-in visitor, Custom Fields, reminder settings,
> assistants, Service lines, and Product Items. There is no append or
> partial update. Read the visit first and send every key back exactly as
> read, changing only what you mean to change.

The legacy path `POST /companies/{company_id}/attendance/records` reaches
the same handler. It is deprecated since 2026-07-01 and sunsets on
2027-03-01; use the canonical path. The v3 operation
[`addVisitItem`](../b2b-v3/openapi.yaml#tag/Visits/operation/addVisitItem)
is planned as the append-only contract for adding one Product Item to a
visit. It is not served yet.

### Read, modify, write

1. Read the visit with
   [List Attendance Appointments](#tag/Appointments/operation/list_attendance_appointments),
   using `attendance_id` = `record_{appointment_id}` and these includes:
   `attendance_service_items`, `attendance_service_items.assistants`,
   `attendance_service_items.attendance_service_composite.composite_service`,
   `attendance_good_items`, `attendance_good_items.marks`,
   `attendance_good_items.loyalty_abonement`,
   `attendance_good_items.loyalty_certificate`, `resource_instances`,
   `labels`, `comer`, `custom_field_values`, `client_notification_settings`,
   and `duration_details`.
2. Build one record for each Appointment you change, using the mapping
   below. Leave the other Appointments of the visit out.
3. To add a Product Item, append a line with `id: null`. Keep every existing
   line with its `id` and its values unchanged.
4. Send `is_instant_sms_notification_required: false` and
   `ignore_conflicts: false`.
5. Request `include: ["attendance_good_items"]` and read the Product Items
   back from the response: loyalty programs may change their totals after
   the save.

| Request key | Source in the read |
|---|---|
| `id`, `external_id`, `staff_id`, `date`, `duration`, `comment`, `custom_color`, `clients_count`, `attendance_status_slug` | Appointment attributes with the same names |
| `client_id` | Appointment `client_id`; `null` when it is `0` |
| `technical_break_duration` | `duration_details.technical_break_duration` |
| `resource_instance_ids`, `label_ids` | IDs of the included `resource_instances` and `labels` |
| `comer` | Included `comer` (`id`, `title`) plus `slug` and `type`; `null` when absent |
| `custom_field_values` | Included `custom_field_values` as `code` and `value` |
| `client_notification_settings` | Included `client_notification_settings` |
| `assistants` | `attendance_service_items.assistants`, with the line's `service_id` |
| `attendance_service_items[]` | `id`, `service_id`, `quantity`, `cost_per_unit`, `manual_cost`, `discount_percent`; `composite_service_id` from the composite include |
| `attendance_good_items[]` | `id`, `good_id`, `unit_id`, `storage_id`, `staff_id`, `quantity`, `cost_per_unit`, `manual_cost`, `discount_percent`; `operation_unit_type` from `operation_type_slug`; `number` and `planned_activation_date` from the loyalty includes; `marks` |

`date` is Location wall-clock time without an offset. Echo it exactly;
never derive it from `timestamp`.

### Product Item fields

- `quantity` is in sale units and positive.
- `cost_per_unit` is the unit price before discount. For a new line, use
  the Product's sale price.
- `discount_percent` is the line discount in percent.
- `manual_cost` is the line total after `discount_percent` and before
  loyalty programs: `round(cost_per_unit × quantity × (100 − discount_percent) / 100, 2)`.
  Echo the read's `manual_cost`, never its `cost`, which already includes
  loyalty discounts.
- `operation_unit_type` is `sale` (sold to the Booking User) or
  `consumable` (written off as a Service consumable).
- `storage_id` is the Inventory the Product is written off from, and
  `staff_id` is the Team Member credited with the sale. The web app uses
  the Appointment's Team Member.

### What a save changes

- Expect every record you send to be re-saved in full, even when you echo
  it exactly. The change detection treats an Appointment without a walk-in
  visitor or without a color as changed, so most exact echoes still
  re-save the Appointment. Only a record that passes every check is
  skipped, and then only its Product Items are synchronized.
- A Service or Product Item line without `id` is created. An existing line
  that is missing from the request is deleted, together with any gift card
  or membership it issued. `attendance_good_items: []` deletes every
  Product Item of the Appointment.
- Omitting `assistants` removes the Appointment's assistants, and
  `comer: null` removes its walk-in visitor. `custom_field_values: null`
  and `custom_color: null` keep the stored values.
- The visit's Product Items are saved as one list. Product Items of other
  Appointments in the visit are kept, but they are re-saved and go through
  the loyalty recalculation again; read them back too. *Inferred from the
  code, not verified:* the re-save sends each kept line's after-loyalty
  total as its new pre-loyalty total, so a loyalty discount on those lines
  may be applied twice, and it does not carry a membership's planned
  activation date, so a visit with a specific-date membership on another
  Appointment may fail to save. Prefer visits with a single Appointment
  when loyalty programs discount Products.

### Preconditions and refusals

- **Status.** Product Items require the visit status arrived (`1`) or
  confirmed (`2`). Any other status normally returns `403` with a message
  that product sales are restricted for this status. If no record in the
  request counts as changed, the request instead returns `200`, saves
  none of the Product Items, and deletes every Product Item of the visit.
  Check the status before you send.
- **Arrived side effects.** Changing the status to arrived (`1`) runs
  loyalty auto-programs, writes off Service consumables, and reschedules
  the Booking User's repeat-visit reminders. Changing it to no-show (`-1`)
  sends the cancellation notice.
- **Printed bill.** When the visit's sale bill is printed, including a
  pending fiscal pre-save, Product Item changes return `400`.
- **Stock.** When the Location forbids negative stock, a line that would
  take an Inventory below zero returns `406`. Otherwise stock may go
  negative.
- **Gift cards and memberships.** A gift card needs `number` unless its
  type allows an empty code; a used number, a number outside the type's
  list, or an archived type is refused. A membership whose type expires on
  a specific date needs `planned_activation_date`. Existing gift card and
  membership lines must be echoed with the same `number` and
  `planned_activation_date`; otherwise the save fails or re-issues the
  gift card or membership.
- **Marks.** Each goods marking code in `marks` is at most 256 characters.
- **Group Events.** An Event Appointment is accepted only with exactly one
  unchanged Service line and a `clients_count` within the Event capacity;
  otherwise `400`. Use
  [Update Event Appointment](#tag/Events/operation/update_event_appointment)
  for Event Appointments.
- **One visit per request.** All records must belong to one visit and one
  Booking User and must not set different new statuses; otherwise `400`.
  A deleted Appointment returns `404`. An Appointment waiting for an
  online prepayment cannot be changed.
- **Conflicts.** Unless `ignore_conflicts` is `true`, a busy time slot, a
  Team Member who does not provide the Services, a busy resource, a deleted
  Team Member, or removal of a prepaid Service returns `409`.

### Side effects

- Every save sends the partner webhook "record update" for every
  Appointment of the visit and a push to the Team Member apps, even when
  only Product Items changed.
- A changed date (beyond the Location's threshold), Team Member, or set of
  Services sends the Booking User a "record changed" message. Adding a
  Product Item alone sends no message.
- A Product Item change re-applies the Booking User's loyalty card discount
  programs to the visit. The saved `discount_percent`, `manual_cost`, and
  `cost` may differ from the request.

### Permissions

The Business User needs the right to create or edit Appointments. Product
Items also check the following rights, each returning `403`:

- creating Product sales in Appointments, with its day limit, for a new
  line;
- editing Product sales, their price, and their discount, with the edit
  day limit, for a changed line;
- editing arrived Appointments, and editing fully paid arrived or
  confirmed Appointments.

Changes to the date or Team Member, Services, the comment, Service prices
or discounts, and penalty decisions check their own rights.

## Path parameters

- `location_id` integer, required

## Headers

- `Accept` string, required
- `Content-Type` 'application/json', required
- `Authorization` string, required

## Request body

- AttendanceSaveRequest: Every key listed as required must be present, including keys whose value is `null` or an empty array. Records, Service lines, and Product Item lines reject unknown keys. Nested field names are literal wire names: `staff_id` is the Team Member ID, `good_id` is the Product ID, `storage_id` is the Inventory ID, and `client_id` is the Booking User ID.
  - `records` Record[], required: Appointments to save. All records must belong to the same visit and the same Booking User. Each record replaces the whole Appointment it identifies.
    - union
      - object
        - `id` integer, nullable, required: Appointment ID. `null` creates an Appointment.
        - `external_id` string, required: External Appointment ID. Echo the read's `external_id`.
        - `client_id` integer, nullable, required: Booking User ID; `client_id` is the literal wire field. Must be `null` when the top-level `client` object is sent.
        - `staff_id` integer, required: Team Member ID; `staff_id` is the literal wire field.
        - `date` string, required: Appointment start as Location wall-clock time without an offset. Echo the read's `date` exactly; do not derive it from `timestamp`.
        - `length` integer: Deprecated alias of `duration`
        - `duration` integer: Appointment duration in seconds
        - `technical_break_duration` integer: Technical break after the Appointment, in seconds. Echo `duration_details.technical_break_duration` from the read.
        - `comment` string, required: Appointment comment. Send an empty string when there is none.
        - `custom_color` string, nullable, required: Appointment color without `#`; an empty string or `null` keeps the current color
        - `attendance_status` -1 | 0 | 1 | 2, required: Attendance status: `-1` no-show, `0` waiting, `1` arrived, `2` confirmed. Send this or `attendance_status_slug`.
        - `attendance_status_slug` 'absent' | 'waiting' | 'attended' | 'confirmed': Attendance status slug. Takes precedence over `attendance_status`.
        - `label_ids` integer[], required: Tag IDs. The list replaces the Appointment's Tags.
        - `resource_instance_ids` integer[], required: Resource instance IDs. The list replaces the Appointment's resources.
        - `custom_field_values` object[], nullable, required: Appointment Custom Field values. Echo the read's `custom_field_values` (`code`, `value`). `null` or `[]` leaves the stored values unchanged, but when the visit is or becomes arrived, the Custom Fields that the Location requires on arrival must be sent. Values are saved only with the Custom Field edit right.
          - `code` string, required: Custom Field code
          - `value` union, required: Custom Field value
            - number
            - string
        - `comer` object, nullable, required: Walk-in visitor of the Appointment. `null` removes the visitor.
          - `id` integer, nullable, required: Walk-in visitor ID
          - `title` string, required: Walk-in visitor name
          - `slug` string, required: Required by validation; not stored
          - `type` 1 | 2 | 3 | null, nullable, required: Visitor type; `1` person, `2` pet, `3` vehicle. `null` means person.
        - `client_notification_settings` object, required: Booking User reminder settings. Echo the read's `client_notification_settings`.
          - `sms_hours_before_visit` integer, required: Hours before the Appointment to send the SMS reminder; `0` disables it
          - `email_hours_before_visit` integer, required: Hours before the Appointment to send the email reminder; `0` disables it
        - `is_instant_sms_notification_required` boolean, required: Send the Booking User an immediate SMS about the Appointment. Send `false` when you only edit Services or Product Items.
        - `attendance_service_items` ServiceItem[], required: Service lines of the Appointment. The list replaces the Appointment's Services: a line without `id` is created and an existing line that is not sent is deleted.
          - `id` integer, nullable, required: Appointment Service line ID; `null` creates a line
          - `service_id` integer, required: Service ID
          - `quantity` integer, required: Number of Service units
          - `cost_per_unit` number, required: Unit price before discount
          - `manual_cost` number, required: Line total after `discount_percent`. It must match `cost_per_unit × quantity × (100 − discount_percent) / 100`; otherwise the request returns `400`.
          - `discount_percent` number, required: Discount in percent
          - `composite_service_id` integer, nullable: Composite Service ID when the line belongs to a composite Service. Read it from `attendance_service_items.attendance_service_composite.composite_service`.
        - `attendance_good_items` ProductItem[], required: Product Item lines of the Appointment; `attendance_good_items` is the literal wire field. The list replaces the Appointment's Product Items: a line with `id: null` is created and an existing line that is not sent is deleted. `[]` deletes every Product Item of the Appointment.
          - `id` integer, nullable, required: Appointment Product Item ID. `null` creates a line. An ID that does not belong to this Appointment returns `422`.
          - `good_id` integer, required: Product ID; `good_id` is the literal wire field.
          - `unit_id` integer, required: Unit ID. Echo the read's `unit_id`; for a new line send the Product's sale unit. The stored unit always comes from the Product.
          - `storage_id` integer, required: Inventory ID to write the Product off from; `storage_id` is the literal wire field.
          - `staff_id` integer, required: Team Member ID credited with the sale; `staff_id` is the literal wire field. The web app uses the Appointment's Team Member.
          - `operation_unit_type` 'sale' | 'consumable', required: `sale` sells the Product to the Booking User; `consumable` writes it off as a Service consumable. Echo the read's `operation_type_slug`.
          - `number` string, nullable, required: Gift card or membership number. Required for a gift card unless its type allows an empty code, and for an existing gift card or membership line, where it must equal the read's `loyalty_certificate.number` or `loyalty_abonement.number`. `null` for plain Products.
          - `planned_activation_date` string, date, nullable, required: Planned membership activation date (`YYYY-MM-DD`). Required when the membership type expires on a specific date. Echo the read's `loyalty_abonement.planned_activation_date`; `null` for other lines.
          - `marks` string[], required: Goods marking codes for the line. Echo the read's `marks`; send `[]` when the Product is not marked.
          - `quantity` number, required: Quantity in sale units, as a positive number. Echo the read's `quantity`.
          - `cost_per_unit` number, required: Unit price before discount. For a new line, the Product's sale price.
          - `manual_cost` number, required: Line total after `discount_percent` and before loyalty programs: `round(cost_per_unit × quantity × (100 − discount_percent) / 100, 2)`. Echo the read's `manual_cost`, never its `cost`; `cost` already includes loyalty discounts, and sending it applies them twice.
          - `discount_percent` number, required: Discount in percent
        - `clients_count` integer, required: Number of places reserved by the Appointment
        - `assistants` object[]: Assistants per Service line. The list replaces the Appointment's assistants, and omitting the key removes them all. Echo every assistant from `attendance_service_items.assistants`.
          - `service_id` integer, required: Service ID of the line the assistant works on
          - `assistant_id` integer, required: Team Member ID of the assistant
          - `compensation_share_percent` number, required: Assistant's share of the Service compensation, in percent
        - `penalty_charge_decision` object, nullable: Decision on a payment-policy penalty that this save triggers. Omit it unless you change the date or set a no-show. Requires the Appointment finances right.
          - `type` 'no_show' | 'late_reschedule' | 'cancellation', required
          - `decision` 'apply' | 'forgive', required
      - object
        - `id` integer, nullable, required: Appointment ID. `null` creates an Appointment.
        - `external_id` string, required: External Appointment ID. Echo the read's `external_id`.
        - `client_id` integer, nullable, required: Booking User ID; `client_id` is the literal wire field. Must be `null` when the top-level `client` object is sent.
        - `staff_id` integer, required: Team Member ID; `staff_id` is the literal wire field.
        - `date` string, required: Appointment start as Location wall-clock time without an offset. Echo the read's `date` exactly; do not derive it from `timestamp`.
        - `length` integer: Deprecated alias of `duration`
        - `duration` integer: Appointment duration in seconds
        - `technical_break_duration` integer: Technical break after the Appointment, in seconds. Echo `duration_details.technical_break_duration` from the read.
        - `comment` string, required: Appointment comment. Send an empty string when there is none.
        - `custom_color` string, nullable, required: Appointment color without `#`; an empty string or `null` keeps the current color
        - `attendance_status` -1 | 0 | 1 | 2: Attendance status: `-1` no-show, `0` waiting, `1` arrived, `2` confirmed. Send this or `attendance_status_slug`.
        - `attendance_status_slug` 'absent' | 'waiting' | 'attended' | 'confirmed', required: Attendance status slug. Takes precedence over `attendance_status`.
        - `label_ids` integer[], required: Tag IDs. The list replaces the Appointment's Tags.
        - `resource_instance_ids` integer[], required: Resource instance IDs. The list replaces the Appointment's resources.
        - `custom_field_values` object[], nullable, required: Appointment Custom Field values. Echo the read's `custom_field_values` (`code`, `value`). `null` or `[]` leaves the stored values unchanged, but when the visit is or becomes arrived, the Custom Fields that the Location requires on arrival must be sent. Values are saved only with the Custom Field edit right.
          - `code` string, required: Custom Field code
          - `value` union, required: Custom Field value
            - number
            - string
        - `comer` object, nullable, required: Walk-in visitor of the Appointment. `null` removes the visitor.
          - `id` integer, nullable, required: Walk-in visitor ID
          - `title` string, required: Walk-in visitor name
          - `slug` string, required: Required by validation; not stored
          - `type` 1 | 2 | 3 | null, nullable, required: Visitor type; `1` person, `2` pet, `3` vehicle. `null` means person.
        - `client_notification_settings` object, required: Booking User reminder settings. Echo the read's `client_notification_settings`.
          - `sms_hours_before_visit` integer, required: Hours before the Appointment to send the SMS reminder; `0` disables it
          - `email_hours_before_visit` integer, required: Hours before the Appointment to send the email reminder; `0` disables it
        - `is_instant_sms_notification_required` boolean, required: Send the Booking User an immediate SMS about the Appointment. Send `false` when you only edit Services or Product Items.
        - `attendance_service_items` ServiceItem[], required: Service lines of the Appointment. The list replaces the Appointment's Services: a line without `id` is created and an existing line that is not sent is deleted.
          - `id` integer, nullable, required: Appointment Service line ID; `null` creates a line
          - `service_id` integer, required: Service ID
          - `quantity` integer, required: Number of Service units
          - `cost_per_unit` number, required: Unit price before discount
          - `manual_cost` number, required: Line total after `discount_percent`. It must match `cost_per_unit × quantity × (100 − discount_percent) / 100`; otherwise the request returns `400`.
          - `discount_percent` number, required: Discount in percent
          - `composite_service_id` integer, nullable: Composite Service ID when the line belongs to a composite Service. Read it from `attendance_service_items.attendance_service_composite.composite_service`.
        - `attendance_good_items` ProductItem[], required: Product Item lines of the Appointment; `attendance_good_items` is the literal wire field. The list replaces the Appointment's Product Items: a line with `id: null` is created and an existing line that is not sent is deleted. `[]` deletes every Product Item of the Appointment.
          - `id` integer, nullable, required: Appointment Product Item ID. `null` creates a line. An ID that does not belong to this Appointment returns `422`.
          - `good_id` integer, required: Product ID; `good_id` is the literal wire field.
          - `unit_id` integer, required: Unit ID. Echo the read's `unit_id`; for a new line send the Product's sale unit. The stored unit always comes from the Product.
          - `storage_id` integer, required: Inventory ID to write the Product off from; `storage_id` is the literal wire field.
          - `staff_id` integer, required: Team Member ID credited with the sale; `staff_id` is the literal wire field. The web app uses the Appointment's Team Member.
          - `operation_unit_type` 'sale' | 'consumable', required: `sale` sells the Product to the Booking User; `consumable` writes it off as a Service consumable. Echo the read's `operation_type_slug`.
          - `number` string, nullable, required: Gift card or membership number. Required for a gift card unless its type allows an empty code, and for an existing gift card or membership line, where it must equal the read's `loyalty_certificate.number` or `loyalty_abonement.number`. `null` for plain Products.
          - `planned_activation_date` string, date, nullable, required: Planned membership activation date (`YYYY-MM-DD`). Required when the membership type expires on a specific date. Echo the read's `loyalty_abonement.planned_activation_date`; `null` for other lines.
          - `marks` string[], required: Goods marking codes for the line. Echo the read's `marks`; send `[]` when the Product is not marked.
          - `quantity` number, required: Quantity in sale units, as a positive number. Echo the read's `quantity`.
          - `cost_per_unit` number, required: Unit price before discount. For a new line, the Product's sale price.
          - `manual_cost` number, required: Line total after `discount_percent` and before loyalty programs: `round(cost_per_unit × quantity × (100 − discount_percent) / 100, 2)`. Echo the read's `manual_cost`, never its `cost`; `cost` already includes loyalty discounts, and sending it applies them twice.
          - `discount_percent` number, required: Discount in percent
        - `clients_count` integer, required: Number of places reserved by the Appointment
        - `assistants` object[]: Assistants per Service line. The list replaces the Appointment's assistants, and omitting the key removes them all. Echo every assistant from `attendance_service_items.assistants`.
          - `service_id` integer, required: Service ID of the line the assistant works on
          - `assistant_id` integer, required: Team Member ID of the assistant
          - `compensation_share_percent` number, required: Assistant's share of the Service compensation, in percent
        - `penalty_charge_decision` object, nullable: Decision on a payment-policy penalty that this save triggers. Omit it unless you change the date or set a no-show. Requires the Appointment finances right.
          - `type` 'no_show' | 'late_reschedule' | 'cancellation', required
          - `decision` 'apply' | 'forgive', required
  - `client` Client: Booking User contacts. Send it only to create a Booking User or to attach one found by these contacts; every record must then have `client_id: null`. Omit it when you edit an existing Appointment.
    - `id` integer, nullable, required: Booking User ID, when known
    - `name` string, required: First name
    - `phone` string, nullable, required: Phone number in international format, digits only, or an empty string
    - `email` string, email, nullable, required: Email address
    - `surname` string, nullable, required: Last name
    - `patronymic` string, nullable, required: Middle name
    - `gender` 0 | 1 | 2 | null, nullable, required: `0` not specified, `1` male, `2` female
    - `birthday` string, date, nullable, required: Date of birth (`YYYY-MM-DD`)
    - `custom_field_values` object[], nullable, required: Booking User Custom Field values
      - `code` string, required
      - `value` string, required
    - `agreements` object, nullable, required: Consent flags, when the Location uses Booking User agreements
      - `is_newsletter_allowed` boolean, required
      - `is_personal_data_processing_allowed` boolean, required
    - `comment` string: Booking User comment
    - `national_id` string, nullable: National identification number
  - `ignore_conflicts` boolean: Skip the scheduling conflict checks (time slot, Team Member services, resources, deleted Team Member, prepaid Service removal, Booking User contact changes). Permission checks still apply.
  - `include` string[]: Includes accepted by the attendance operations. They extend the Appointment includes with the nested includes needed to read back every key that [Save Visit Appointments](#tag/Appointments/operation/save_attendance_appointments) requires. Values are literal API keys.

## Response `200`

Appointments saved. `data` lists every Appointment of the affected
visits, including Appointments that were not in the request.

- object
  - `data` AppointmentResource[], required
    - `type` 'record', required: Literal JSON:API resource type
    - `id` string, required: Appointment ID
    - `attributes` object, required
      - `company_id` integer, required: Location ID
      - `external_id` string, required: External Appointment ID
      - `visit_id` integer, required: Linked visit ID, or `0` when not linked
      - `booking_user_id` integer, required: Booking User account ID, or `0`
      - `bookform_id` integer, required: Booking form ID, or `0`
      - `master_id` integer, required: Deprecated wire field for Team Member ID; use `staff_id`
      - `staff_id` integer, required: Team Member ID
      - `client_id` integer, required: Booking User profile ID, or `0` when absent
      - `comer_id` integer, nullable, required: Walk-in visitor ID
      - `source` integer, required: Appointment source wire value
      - `attendance` -1 | 0 | 1 | 2, required: Deprecated attendance wire value; use `attendance_status_slug`
      - `attendance_status` -1 | 0 | 1 | 2, required: Deprecated attendance status; use `attendance_status_slug`
      - `attendance_status_slug` 'absent' | 'waiting' | 'attended' | 'confirmed', required: Appointment attendance status
      - `client_fictive_name` string, nullable, required: Fallback Booking User name stored on the Appointment
      - `client_fictive_phone` string, nullable, required: Fallback Booking User phone stored on the Appointment
      - `client_fictive_email` string, nullable, required: Fallback Booking User email stored on the Appointment
      - `clients_count` integer, required: Number of Booking Users in the Appointment
      - `activity_id` integer, required: Event ID, or `0` when the Appointment is not part of an Event
      - `custom_color` string, required: Appointment background color without `#`, or an empty string
      - `custom_font_color` string, required: Appointment text color without `#`, or an empty string
      - `length` integer, required: Deprecated duration in seconds; use `duration`
      - `duration` integer, required: Appointment duration in seconds
      - `paid_full` 0 | 1 | 2, required: Deprecated payment wire value; use `is_paid` and `is_overpaid`
      - `is_paid` boolean, required: Whether the Appointment is fully paid
      - `is_overpaid` boolean, required: Whether the Appointment is overpaid
      - `timestamp` integer, required: Appointment start as a Unix timestamp
      - `date` string, required: Appointment start in the Location timezone, without an offset
      - `created_datetime` string, required: Creation date and time in the Location timezone, without an offset
      - `from_url` string, required: Source URL, or an empty string
      - `is_mobile` integer, required: Mobile-origin wire status
      - `comment` string, required: Appointment comment
      - `prepaid_status` integer, required: Prepayment status wire value
      - `record_from` string, required: Human-readable Appointment source, or an empty string
      - `payment_status` integer, nullable, required: Membership auto-payment status, when available
      - `is_sale_bill_printed` boolean, nullable, required: Whether the sale bill is printed, when available
      - `is_client_notification_sent` boolean, required: Whether a Booking User notification was sent
    - `relationships` object: Present when related data is requested through `include`
      - `client` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `staff` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `services` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `goods` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `resource_instances` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `labels` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `attendance_service_items` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `attendance_good_items` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `attendance_document` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `transactions` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `fast_payment_settings` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `acceptance_free` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `custom_field_values` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `comer` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `client_notification_settings` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `client_schedule` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `duration_details` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
  - `included` IncludedResource[]: Resources requested through `include`, when available
    - `type` string, required
    - `id` string, required
    - `attributes` object, required
    - `relationships` object

## Other responses

- `400`: Business rule refused the save: records from different visits or Booking Users, different new statuses, a Service total that does not match its discount, a printed bill, a gift card or membership rule, an Event Appointment rule, or an Appointment waiting for prepayment
- `401`: Unauthorized
- `403`: Forbidden - missing Appointment, Product sale, price, discount, or status right, a day limit, or a product sale in a status other than arrived or confirmed
- `404`: Location or Appointment not found, or the Appointment is deleted
- `406`: Not enough stock in the Inventory, and the Location forbids negative stock
- `409`: Scheduling conflict; resend with `ignore_conflicts` to override
- `422`: Request validation failed, a Product Item `id` does not belong to the Appointment, or a payment policy blocks the status change

## Changes

- **2026-10-20** `a2d63320b944`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alteg/apis/business-management/changes/locations/:location_id/attendance/appointments/post.md)

---

[API](https://skmtc.dev/alteg/apis/business-management.md) - [All operations](https://skmtc.dev/alteg/apis/business-management/llms.txt) - [OpenAPI document](https://skmtc.dev/alteg/apis/business-management/revisions/a2d63320b944?raw)
