---
title: "Add item to list"
method: POST
path: "/api/v1/user/lists/{id}/items"
tags: ["User"]
---

# Add item to list

`POST /api/v1/user/lists/{id}/items`

## Path parameters

- `id` integer, required

## Headers

- `X-CSRF-Token` string, required

## Request body

- UserListItemCreateRequest
  - `type` 'company' | 'person', required
  - `slug` string, required
  - `note` string

## Response `201`

Added

- OkResponse
  - `ok` boolean, required

## Other responses

- `400` — Invalid request
- `401` — Authentication required (no active session)
- `403` — Invalid CSRF
- `404` — Resource not found

## Changes

- **2026-07-26** `996f96a11758` — 2 breaking, 1 warning, 6 info
  - added the new required `header` request parameter `X-CSRF-Token`
  - added required request body
  - for the `path` request parameter `id`, the min was set to `1.00`
  - api operation id `postUserListsByIdItems` was added
  - …5 more

[Change history](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/changes/api/v1/user/lists/:id/items/post.md)

---

[API](https://skmtc.dev/openmercantil/apis/openmercantil-public-api.md) · [All operations](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openmercantil/openmercantil-public-api/revisions/601ff6123c86/schema)