---
title: "Create Event Appointment"
method: POST
path: "/locations/{location_id}/events/{event_id}/appointments"
tags: ["Events"]
---

# Create Event Appointment

`POST /locations/{location_id}/events/{event_id}/appointments`

## Request

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

Create an Appointment in an Event. The literal `client` wire object is
required for both an existing and a new Booking User.

## Path parameters

- `location_id` integer, required
- `event_id` integer, required

## Query parameters

- `include` string[]

## Headers

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

## Request body

- EventAppointmentCreateRequest
  - `client_id` integer, nullable: Deprecated wire field for an existing Booking User ID; use `client.id`
  - `comer_id` integer, nullable: Walk-in visitor ID
  - `client` object, required
    - `id` integer, nullable, required: Existing Booking User ID, or `null` for a new Booking User
    - `name` string, required: Booking User first name
    - `phone` union, required: Booking User phone number as 9 to 15 digits; an empty string is also accepted
      - ''
      - string
    - `email` string, email, nullable, required: Booking User email address
    - `surname` string, nullable, required: Booking User last name
    - `patronymic` string, nullable, required: Literal wire field for a Booking User middle name
    - `gender` 0 | 1 | 2 | null, nullable, required: Booking User gender wire value
    - `birthday` string, date, nullable, required: Booking User birth date
    - `custom_field_values` object[], nullable, required: Booking User custom fields
      - `code` string, required
      - `value` string, required
    - `agreements` object, nullable, required: Booking User consent flags
      - `is_newsletter_allowed` boolean, required
      - `is_personal_data_processing_allowed` boolean, required
    - `comment` string: Booking User comment
    - `national_id` string, nullable: Booking User national identifier - the client IIN for locations in Kazakhstan, where it must be 12 digits with a valid check digit. Accepted only for locations in Kazakhstan and ignored for other countries. When omitted or null, the IIN already saved for the client is left unchanged.
  - `comer` object
    - `name` string: Walk-in visitor name
  - `clients_count` integer, required: Number of places reserved by the Appointment
  - `is_trial_service` boolean: Whether this is a trial Service Appointment

## Response `201`

Event Appointment created successfully

- EventAppointmentItemResponse
  - `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
  - `meta` unknown[], required: Empty JSON array returned for an Event Appointment item
    - unknown

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - No permission to create Appointments
- `404`: Location or Event not found, including a deleted Event
- `422`: Request validation failed

## Changes

- **2026-09-29** `a3a7f7158533`: 1 info
  - response property `data/attributes/master_id` deprecated

[Operation history](https://skmtc.dev/alteg/apis/business-management/changes/locations/:location_id/events/:event_id/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)
