---
title: "Create a checklist item"
method: POST
path: "/api/v1/checklist_items"
tags: ["Checklists"]
---

# Create a checklist item

`POST /api/v1/checklist_items`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/checklist_items`
- Auth: none declared. Required headers: `Api-Key`

Adds a new item to a checklist. When `checklist_id` is supplied, the item is added to that checklist. When it's omitted, the item is added to the franchise-wide "Shared Checklist" (created on first use).

**Required permission:** `assigned_event_write` (when the authenticated user is assigned to the target checklist's event) or `unassigned_event_write` (otherwise). Staff users without admin role need the per-checklist `allow_staff_edit` flag instead; customers need `allow_customer_edit`. Items on user-checklists (personal task lists) can only be created by their owner.

## Headers

- `Api-Key` string, required

## Request body

- object
  - `title` string, required: Item title
  - `notes` string: Free-form notes
  - `due_on` string: Due date (YYYY-MM-DD)
  - `checklist_id` integer: Optional ID of the checklist to add the item to. Omit to use the franchise-wide Shared Checklist.
  - `checked` boolean: Whether the new item should start in the checked state
  - `user_ids` integer[]: Staff member IDs to assign to this item

## Response `200`

checklist item created

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)