# Create Booking

Create a new booking for an event.

Endpoint: POST /v1/bookings
Version: 0.1.0
Security: OAuth2

## Request fields (application/json):

  - `event_id` (string, required)
    The unique identifier of the event.

  - `customer` (any, required)
    The customer making the booking.

  - `locale` (string, required)
    Combination of language and country/region.
The format is a lowercase ISO 639-1 language code followed by an optional hyphen and an
uppercase ISO 3166-1 country code.

  - `items` (array, required)

  - `items.type_id` (string, required)
    The unique identifier of the item type.

  - `items.item_type` (string, required)
    The type of item.
    Enum: "VARIANT", "ADDON", "UNKNOWN"

  - `items.quantity` (integer, required)
    The quantity of the item.

  - `metadata` (object)
    Additional metadata for the booking.

This property lets you add custom data to the booking, e.g. your own booking reference.
The key has a limit of 40 characters and the value has a limit of 500 characters.

## Response 201 fields (application/json):

  - `id` (string, required)
    The unique identifier of the booking.

  - `status` (string, required)
    The status of the booking.

This will always be "ACTIVE" when the booking is created.
    Enum: "ACTIVE", "CANCELLED", "MOVED", "PROCESSING", "CHECKED_IN", "UNKNOWN"

## Response 400 fields (application/json):

  - `message` (string, required)

  - `code` (string, required)

## Response 409 fields (application/json):

  - `message` (string, required)

  - `code` (string, required)

## Response default fields (application/json):

  - `message` (string, required)

  - `code` (string, required)