---
title: "Create Data Items"
method: POST
path: "/collections/{collectionId}/items"
tags: ["Data Item"]
---

# Create Data Items

`POST /collections/{collectionId}/items`

## Request

- Base URL: `https://data.lucid.app`
- URL: `https://data.lucid.app/collections/{collectionId}/items`
- Auth: OAuth 2
  - Authorization code: `https://lucid.app/oauth2/authorize`
  - Token URL: `https://api.lucid.co/oauth2/token` scopes: `data-service.admin`

If the user has access to the collection, new data items are created using the supplied values. Primary key constraints are not enforced. Any field name that is not part of the schema definition is ignored by default. The schema should be created prior to any data items being created.

## Path parameters

- `collectionId` integer, required

## Request body

- object[]: Field value pairs to create data items from. Each mapping is for a single data item

## Response `200`

OK with Array[Data Item] containing the newly created data items

- object[]
  - `uri` string, required: Link to self
  - `collection` string, required: Link to the collection the item belongs to
  - `fields` object, required: Mapping of field names found in schema to this specific item's values

---

[API](https://skmtc.dev/lucid/apis/lucid-data-api.md) - [All operations](https://skmtc.dev/lucid/apis/lucid-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lucid/apis/lucid-data-api/revisions/c14ed29dbeab?raw)