# Create enrollment

Creates a new enrollment code that a device can use to register.

Endpoint: POST /ipp/v1/enrollments
Version: 1.0.0

## Request fields (application/json):

  - `metadata` (object)
    Custom metadata key-value pairs for the enrollment.
    Example: {"store_id":"123","terminal_type":"checkout"}

  - `expires_in` (integer)
    Time in milliseconds until the enrollment code expires. Defaults to 7200000 (2 hours).
    Example: 360000

  - `location_id` (string)
    Location ID to associate the enrolled device with.
    Example: "550e8400-e29b-41d4-a716-446655440000"

## Response 201 fields (application/json):

  - `enrollment_id` (string)
    Unique enrollment identifier.
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `enrollment_code` (string)
    The enrollment code to enter on the device.
    Example: "ABC123XYZ"

  - `expires_at` (string)
    Timestamp when the enrollment code expires.
    Example: "2024-01-15T11:30:00Z"

  - `status` (string)
    Current status of the enrollment.
    Enum: "PENDING", "CONSUMED", "EXPIRED", "CANCELLED"

  - `metadata` (object)
    Custom metadata key-value pairs for the enrollment.
    Example: {"store_id":"123","terminal_type":"checkout"}


## Response 400 fields

## Response 401 fields