# Create Collection Item

`lawmatics_create-collection-item` · Lawmatics MCP tool · Collection Items

Create a collection item in Lawmatics: one row of data conforming to a Collection's schema, attached to a matter (the only record type the API accepts). Optionally set the row's cell values via customFieldValues.

## Input

- **collectionId** `string` (required) — ID of the parent Collection whose schema this item conforms to
- **matterId** `string` (required) — ID of the matter to attach this item to (matters are the only record type the Lawmatics API accepts for collection items)
- **customFieldValues** `array` — Cell values to set on the item, one per Collection custom field
  - **[]** `object`
    - **id** `string | number` (required) — ID of the Collection's custom field to set (the create example sends a number, the update example a string; either type is accepted here)
    - **value** `string | number | boolean | null` (required) — Cell value to set (matches the field's type); pass null to clear the field. Dates are written as ISO 8601 strings (e.g. '1999-03-31')

## Output

- **id** `string` (required) — Unique ID of the created collection item
- **collectionId** `string` (required) — ID of the parent Collection this item belongs to, as a numeric string
- **ownerType** `string` (required) — Type of the record this item is attached to as returned by the API — always "Prospect" (a matter) today; the live API rejects other record types on create
- **ownerId** `string` (required) — ID of the record this item is attached to, as a numeric string
- **customFieldValues** `array` (required) — Cell values stored on this item, one per Collection custom field; empty if none
  - **[]** `object`
    - **id** `string` (required) — ID of this stored cell value row, as a numeric string
    - **customFieldId** `string` (required) — ID of the Collection custom field definition this value belongs to, as a numeric string
    - **name** `string | null` (required) — Custom field display name; null if not reported
    - **fieldType** `string | null` (required) — Custom field data type (e.g. text, date, select); null if not reported
    - **value** `any` (required) — Raw stored cell value; type varies by fieldType; null if unset
    - **formattedValue** `any` (required) — Display-formatted cell value; type varies by fieldType; null if not reported
- **createdAt** `string` (required) — When the item was created, as an ISO 8601 timestamp
- **updatedAt** `string` (required) — When the item was last updated, as an ISO 8601 timestamp