# Create Event Appointment (v2)

Creates an Appointment for a Client in an Event using v2 API.

Note: All client fields are required even when using existing client ID.

Endpoint: POST /v2/companies/{location_id}/activities/{event_id}/records
Version: 1.0.1
Security: BearerPartnerUser

## Header parameters:

  - `Accept` (string, required)

  - `Content-Type` (string, required)

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

## Path parameters:

  - `location_id` (integer, required)
    Location (business) ID

  - `event_id` (integer, required)
    Event ID

## Request fields (application/json):

  - `client` (object, required)
    Client information

  - `client.name` (string, required)
    First name
    Example: "John"

  - `client.phone` (string, required)
    Phone number
    Example: "+13155550175"

  - `client.email` (string, required)
    Email address
    Example: "john@example.com"

  - `client.surname` (string, required)
    Last name
    Example: "Smith"

  - `client.gender` (integer, required)
    Gender: 0 - unknown, 1 - male, 2 - female
    Enum: 0, 1, 2

  - `client.id` (integer)
    Client ID for existing client
    Example: 123456

  - `client.patronymic` (any)
    Middle name (legacy field name)

  - `client.birthday` (any)
    Birth date
    Example: "1990-01-01"

  - `client.custom_field_values` (any)
    Custom field values

  - `client.agreements` (any)
    User agreements/consents

  - `clients_count` (integer, required)
    Number of participants/slots to reserve
    Example: 1

  - `client_id` (integer)
    Existing client ID (deprecated, use client.id instead)
    Example: 123456

  - `comer_id` (integer)
    Visitor ID (alternative to client)
    Example: 500

  - `comer` (object)
    Visitor information (alternative to client)

  - `comer.name` (string)
    Visitor name
    Example: "Guest User"

  - `labels` (array)
    Tag IDs for this appointment
    Example: [1,2]

## Response 201 fields (application/json):

  - `data` (object)
    Created appointment details (JSON:API format)

  - `data.type` (string)
    Example: "record"

  - `data.id` (string)
    Example: "624798251"

  - `data.attributes` (object)

  - `data.attributes.company_id` (integer)

  - `data.attributes.external_id` (string)

  - `data.attributes.visit_id` (integer)

  - `data.attributes.booking_user_id` (integer)

  - `data.attributes.bookform_id` (integer)

  - `data.attributes.master_id` (integer)

  - `data.attributes.staff_id` (integer)

  - `data.attributes.client_id` (integer)

  - `data.attributes.comer_id` (integer,null)

  - `data.attributes.source` (integer)

  - `data.attributes.attendance` (integer)

  - `data.attributes.attendance_status` (integer)

  - `data.attributes.attendance_status_slug` (string)

  - `data.attributes.client_fictive_name` (string,null)

  - `data.attributes.client_fictive_phone` (string,null)

  - `data.attributes.client_fictive_email` (string,null)

  - `data.attributes.clients_count` (integer)

  - `data.attributes.activity_id` (integer)

  - `data.attributes.custom_color` (string)

  - `data.attributes.custom_font_color` (string)

  - `data.attributes.length` (integer)

  - `data.attributes.duration` (integer)

  - `data.attributes.paid_full` (integer)

  - `data.attributes.is_paid` (boolean)

  - `data.attributes.is_overpaid` (boolean)

  - `data.attributes.timestamp` (integer)

  - `data.attributes.date` (string)

  - `data.attributes.created_datetime` (string)

  - `data.attributes.from_url` (string)

  - `data.attributes.is_mobile` (integer)

  - `data.attributes.comment` (string)

  - `data.attributes.prepaid_status` (integer)

  - `data.attributes.record_from` (string)

  - `data.attributes.payment_status` (integer)

  - `data.attributes.is_sale_bill_printed` (boolean)

  - `data.attributes.is_client_notification_sent` (boolean)

  - `meta` (array)

## Response 401 fields (application/json):

  - `success` (boolean)

  - `data` (null)

  - `meta` (object)

## Response 403 fields (application/json):

  - `success` (boolean)

  - `data` (null)

  - `meta` (object)

## Response 404 fields (application/json):

  - `success` (boolean)

  - `data` (null)

  - `meta` (object)

  - `meta.message` (string)
    Example: "Not found"

## Response 422 fields (application/json):

  - `success` (boolean)

  - `data` (null)

  - `meta` (object)

  - `meta.message` (string)
    Example: "An error has occurred"

  - `meta.errors` (object)
    Field-level validation errors