# Create Event Appointment

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

Endpoint: POST /locations/{location_id}/events/{event_id}/appointments
Version: 2.0.0
Security: BearerPartnerUser

## Security:

  - `BearerPartnerUser` (unknown)
    http bearer Bearer {PartnerToken}, User {UserToken}

## Path parameters:

  - `location_id` (integer, required)
    Location ID

  - `event_id` (integer, required)
    Event ID

## Query parameters:

  - `include` (array)
    Related resources to include in the created Appointment

## Header parameters:

  - `Accept` (string, required)
    Required B2B v2 response media type. Use `application/vnd.api.v2+json`. A charset parameter is also accepted.

  - `Content-Type` (string, required)
    Request media type

  - `Authorization` (string, required)
    Bearer {partner_token}, User {user_token}

## Request fields (application/json):

  - `client_id` (integer | null)
    Deprecated wire field for an existing Booking User ID; use `client.id`

  - `comer_id` (integer | null)
    Walk-in visitor ID

  - `client` (object, required)

  - `client.id` (integer | null, required)
    Existing Booking User ID, or `null` for a new Booking User

  - `client.name` (string, required)
    Booking User first name

  - `client.phone` (any, required)
    Booking User phone number as 9 to 15 digits; an empty string is also accepted

  - `client.email` (string | null, required)
    Booking User email address

  - `client.surname` (string | null, required)
    Booking User last name

  - `client.patronymic` (string | null, required)
    Literal wire field for a Booking User middle name

  - `client.gender` (integer | null, required)
    Booking User gender wire value
    Enum: "0", "1", "2", "null"

  - `client.birthday` (string | null, required)
    Booking User birth date

  - `client.custom_field_values` (any, required)
    Booking User custom fields

  - `client.custom_field_values.code` (string, required)

  - `client.custom_field_values.value` (string, required)

  - `client.agreements` (any, required)
    Booking User consent flags

  - `client.agreements.is_newsletter_allowed` (boolean, required)

  - `client.agreements.is_personal_data_processing_allowed` (boolean, required)

  - `client.comment` (string)
    Booking User comment

  - `client.national_id` (string | null)
    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)

  - `comer.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:

  - `201` (unknown)
    Event Appointment created successfully

## Response 201 fields (application/json):

  - `data` (object, required)

  - `data.type` (string, required)
    Literal JSON:API resource type
    Enum: "record"

  - `data.id` (string, required)
    Appointment ID

  - `data.attributes` (object, required)

  - `data.attributes.company_id` (integer, required)
    Location ID

  - `data.attributes.external_id` (string, required)
    External Appointment ID

  - `data.attributes.visit_id` (integer, required)
    Linked visit ID, or `0` when not linked

  - `data.attributes.booking_user_id` (integer, required)
    Booking User account ID, or `0`

  - `data.attributes.bookform_id` (integer, required)
    Booking form ID, or `0`

  - `data.attributes.master_id` (integer, required)
    Deprecated wire field for Team Member ID; use `staff_id`

  - `data.attributes.staff_id` (integer, required)
    Team Member ID

  - `data.attributes.client_id` (integer, required)
    Booking User profile ID, or `0` when absent

  - `data.attributes.comer_id` (integer | null, required)
    Walk-in visitor ID

  - `data.attributes.source` (integer, required)
    Appointment source wire value

  - `data.attributes.attendance` (integer, required)
    Deprecated attendance wire value; use `attendance_status_slug`
    Enum: "-1", "0", "1", "2"

  - `data.attributes.attendance_status` (integer, required)
    Deprecated attendance status; use `attendance_status_slug`
    Enum: "-1", "0", "1", "2"

  - `data.attributes.attendance_status_slug` (string, required)
    Appointment attendance status
    Enum: "absent", "waiting", "attended", "confirmed"

  - `data.attributes.client_fictive_name` (string | null, required)
    Fallback Booking User name stored on the Appointment

  - `data.attributes.client_fictive_phone` (string | null, required)
    Fallback Booking User phone stored on the Appointment

  - `data.attributes.client_fictive_email` (string | null, required)
    Fallback Booking User email stored on the Appointment

  - `data.attributes.clients_count` (integer, required)
    Number of Booking Users in the Appointment

  - `data.attributes.activity_id` (integer, required)
    Event ID, or `0` when the Appointment is not part of an Event

  - `data.attributes.custom_color` (string, required)
    Appointment background color without `#`, or an empty string

  - `data.attributes.custom_font_color` (string, required)
    Appointment text color without `#`, or an empty string

  - `data.attributes.length` (integer, required)
    Deprecated duration in seconds; use `duration`

  - `data.attributes.duration` (integer, required)
    Appointment duration in seconds

  - `data.attributes.paid_full` (integer, required)
    Deprecated payment wire value; use `is_paid` and `is_overpaid`
    Enum: "0", "1", "2"

  - `data.attributes.is_paid` (boolean, required)
    Whether the Appointment is fully paid

  - `data.attributes.is_overpaid` (boolean, required)
    Whether the Appointment is overpaid

  - `data.attributes.timestamp` (integer, required)
    Appointment start as a Unix timestamp

  - `data.attributes.date` (string, required)
    Appointment start in the Location timezone, without an offset

  - `data.attributes.created_datetime` (string, required)
    Creation date and time in the Location timezone, without an offset

  - `data.attributes.from_url` (string, required)
    Source URL, or an empty string

  - `data.attributes.is_mobile` (integer, required)
    Mobile-origin wire status

  - `data.attributes.comment` (string, required)
    Appointment comment

  - `data.attributes.prepaid_status` (integer, required)
    Prepayment status wire value

  - `data.attributes.record_from` (string, required)
    Human-readable Appointment source, or an empty string

  - `data.attributes.payment_status` (integer | null, required)
    Membership auto-payment status, when available

  - `data.attributes.is_sale_bill_printed` (boolean | null, required)
    Whether the sale bill is printed, when available

  - `data.attributes.is_client_notification_sent` (boolean, required)
    Whether a Booking User notification was sent

  - `data.relationships` (object)
    Present when related data is requested through `include`

  - `data.relationships.client` (object)

  - `data.relationships.client.data` (any, required)

  - `data.relationships.client.data.type` (string, required)

  - `data.relationships.client.data.id` (string, required)

  - `data.relationships.services` (object)

  - `data.relationships.services.data` (array, required)

  - `included` (array)
    Resources requested through `include`, when available

  - `included.type` (string, required)

  - `included.id` (string, required)

  - `included.attributes` (object, required)

  - `included.relationships` (object)

  - `meta` (array, required)
    Empty JSON array returned for an Event Appointment item

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `success` (boolean, required)
    Enum: "false"

  - `data` (null, required)

  - `meta` (object, required)

  - `meta.message` (string, required)

  - `meta.errors` (object)
    Field-level validation errors, when applicable

## Response 403:

  - `403` (unknown)
    Forbidden - No permission to create Appointments

## Response 403 fields (application/json):

  - `success` (boolean, required)
    Enum: "false"

  - `data` (null, required)

  - `meta` (object, required)

  - `meta.message` (string, required)

  - `meta.errors` (object)
    Field-level validation errors, when applicable

## Response 404:

  - `404` (unknown)
    Location or Event not found, including a deleted Event

## Response 404 fields (application/json):

  - `success` (boolean, required)
    Enum: "false"

  - `data` (null, required)

  - `meta` (object, required)

  - `meta.message` (string, required)

  - `meta.errors` (object)
    Field-level validation errors, when applicable

## Response 422:

  - `422` (unknown)
    Request validation failed

## Response 422 fields (application/json):

  - `success` (boolean, required)
    Enum: "false"

  - `data` (null, required)

  - `meta` (object, required)

  - `meta.message` (string, required)

  - `meta.errors` (object)
    Field-level validation errors, when applicable