---
search:
  tags:
    - projects
    - POST
seo:
  description: >-
    Creates a new todo checklist item within a project… Reference for the POST
    /projects/{projectId}/items/{itemId}/todos endpoint in the Leadtime Public
    API API.
sidebar:
  badge: POST
  label: Create a new todo (checklist item) for a component item
title: Create a new todo (checklist item) for a component item
type: openapi-operation
---
Creates a new todo checklist item within a project component item. Todos are actionable checklist items that help track progress and ensure nothing is missed.

**What are Todos?**
Todos are checklist items used to track actionable tasks within component items. They are perfect for:
- Recurring processes (tests, approvals, installation steps)
- Quality control checkpoints
- Project preparation steps
- Final checks before go-live
- Kickoff checklists
- Review and approval workflows

**Todo Features:**
Each todo can be:
- Checked off individually to track completion
- Commented on to add notes or context
- Tracked with completion status (isDone), who completed it (doneBy), and when (doneUpdatedAt)

**Where Todos Can Be Attached:**
Todos can be attached to Work Packages or Todo List items. When attached to a Todo List, they become sub-items in a checklist. When attached to a Work Package, they serve as actionable steps within that work package.

**Content Format:**
The description field accepts HTML or Markdown format and is automatically converted to IDoc format for storage. When retrieved, it is converted back to HTML for easy consumption.

**Automatic Processing:**
After creating a todo, the system automatically:
- Calculates sort order as max(sort) + 1 for todos in the same item, positioning it at the end
- Recalculates all conditions that depend on todo completion status
- Updates timeframes if conditions changed
- Marks the project configuration as changed

**Use Case:**
Create todos to break down work packages into actionable steps, create quality checklists, or define approval workflows. Todos can also be used in conditions to control when other items are visible or active.

<Operation source="api-reference" id="projectcomponentscontroller-createtodo" />