---
search:
  tags:
    - administration
    - POST
seo:
  description: >-
    Creates a new project status to represent a phase in… Reference for the POST
    /administration/project-settings/statuses endpoint in the Leadtime Public
    API API.
sidebar:
  badge: POST
  label: Create project status
title: Create project status
type: openapi-operation
---
Creates a new project status to represent a phase in your project workflow.

**Required fields:**
- `name`: Display name for the status (e.g., "In Progress", "On Hold")
- `icon`: Icon identifier in format :icon_name: (e.g., ":hourglass_flowing_sand:")
- `type`: Status type enum value (Sales, Requirements, Implementation, QualityManagement, Billing, Done)
- `translations`: Array of translations for multilingual support

**Optional fields:**
- `description`: Additional context about when to use this status

**Status type meanings:**
- Sales: Pre-contract phase, customer interest
- Requirements: Specification and planning phase
- Implementation: Active work phase
- QualityManagement: Testing and review phase
- Billing: Ready for invoicing
- Done: Project completed

**Note:** You can create multiple statuses with the same type to split phases into sub-phases (e.g., split Sales into Pitch, Negotiation, Contract closing).

<Operation source="api-reference" id="projectsettingscontroller-createprojectstatus" />