---
search:
  tags:
    - projects
    - POST
seo:
  description: >-
    Creates a new project component (reusable project template)… Reference for
    the POST /projects/{projectId}/components endpoint in the Leadtime Public
    API API.
sidebar:
  badge: POST
  label: Create a new component in a project
title: Create a new component in a project
type: openapi-operation
---
Creates a new project component (reusable project template) with name, description, icon, tags, and internal notes.

**What are Project Components?**
Project components are reusable project templates that standardize recurring project types. They serve as blueprints for planning, pricing, and executing similar projects consistently. Components connect requirements management, cost calculation, and execution in one unified workflow.

**After Creating a Component:**
Once created, you can add items (Epics, Work Packages, Todo Lists, Test Suites) to define the project structure. You can also add questions to capture customer requirements, todos for checklists, and test cases for acceptance testing.

**Component Placement:**
The component is automatically appended to the end of the project component list. You can reorder components later using the sort endpoint.

**Content Format:**
Description and internal note fields accept HTML or Markdown input and are automatically converted to the internal IDoc format for storage. When retrieved, this content is converted back to HTML for easy consumption.

**Side Effects:**
Creating a component automatically triggers project configuration change tracking, marking the project as having been modified.

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