# Create lockbox events

Create new lockbox events (Install or Uninstall)

Endpoint: POST /lockbox_events
Version: 1.1.1
Security: BearerAuth

## Request fields (application/json):

  - `events` (array, required)
    List of lockbox events to create
    Example: [{"lockbox_id":"123e4567-e89b-12d3-a456-426614174000","event_type":"Install","unit_id":12345}]

  - `events.lockbox_id` (string, required)
    ID of the lockbox
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `events.event_type` (string, required)
    Type of event
    Enum: "Install", "Uninstall"

  - `events.unit_id` (number, required)
    ID of the unit to associate with the event
    Example: 12345

## Response 201 fields (application/json):

  - `id` (string, required)
    Unique identifier

  - `lockbox_id` (string, required)
    ID of the lockbox
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `event_type` (string, required)
    Type of event
    Enum: "Install", "Uninstall", "Generate Code"

  - `unit_id` (string, required)
    ID of the unit associated with the event
    Example: "12345"

  - `account_id` (string)
    ID of the account associated with the event
    Example: "4b88ff32-8ba0-4bbf-8e60-c789909ac176"

  - `created_at` (string, required)
    Timestamp when the event occurred
    Example: "2023-01-15T12:30:00Z"

  - `metadata` (object)
    Additional metadata about the event
    Example: {"installer_id":"user_12345","notes":"Installed on front door"}

## Response 400 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]