Create project status

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).

POST/administration/project-settings/statuses

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Request body

requiredapplication/json

descriptionobject

Optional description providing context about when to use this status. Helps users understand the purpose of the status.

iconstringrequired

Icon identifier in emoji format. Must be wrapped in colons (e.g., ":hourglass_flowing_sand:", ":check_mark:", ":moneybag:"). The icon appears next to the status name throughout the application.

namestringrequired

Display name for the project status. Represents a phase in the project workflow (e.g., "In Progress", "On Hold", "Quality Review").

translationsProjectStatusTranslationDto[]required

Array of translations for multilingual support. Each translation object contains a language code and translated name/description. The system automatically displays the correct language based on user preferences.

Show properties

Array of ProjectStatusTranslationDto

descriptionobject

Translated description of the project status in this language. Provides context about when to use this status.

languagestringrequired

ISO 639-1 language code for the translation (e.g., "en" for English, "de" for German)

nameobject

Translated name of the project status in this language. Used for multilingual display in the user interface.

typestringrequired

Status type enum value that categorizes the status. Determines billing eligibility and workflow behavior. Valid values: Sales, Requirements, Implementation, QualityManagement, Billing, Done.

Allowed:SalesRequirementsImplementationQualityManagementBillingDone

Responses

201

Project status created successfully

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Bodyapplication/json

Request body

Request

curl -X POST "https://leadtime.app/api/public/administration/project-settings/statuses" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "Project is currently in development phase",
  "icon": ":hourglass_flowing_sand:",
  "name": "In Progress",
  "translations": [
    {
      "description": "Project is currently in progress",
      "language": "en",
      "name": "In Progress"
    },
    {
      "description": "Projekt ist derzeit in Bearbeitung",
      "language": "de",
      "name": "In Bearbeitung"
    }
  ],
  "type": "Implementation"
}'

const response = await fetch("https://leadtime.app/api/public/administration/project-settings/statuses", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"description\": \"Project is currently in development phase\",\n  \"icon\": \":hourglass_flowing_sand:\",\n  \"name\": \"In Progress\",\n  \"translations\": [\n    {\n      \"description\": \"Project is currently in progress\",\n      \"language\": \"en\",\n      \"name\": \"In Progress\"\n    },\n    {\n      \"description\": \"Projekt ist derzeit in Bearbeitung\",\n      \"language\": \"de\",\n      \"name\": \"In Bearbeitung\"\n    }\n  ],\n  \"type\": \"Implementation\"\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/administration/project-settings/statuses",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"description\": \"Project is currently in development phase\",\n  \"icon\": \":hourglass_flowing_sand:\",\n  \"name\": \"In Progress\",\n  \"translations\": [\n    {\n      \"description\": \"Project is currently in progress\",\n      \"language\": \"en\",\n      \"name\": \"In Progress\"\n    },\n    {\n      \"description\": \"Projekt ist derzeit in Bearbeitung\",\n      \"language\": \"de\",\n      \"name\": \"In Bearbeitung\"\n    }\n  ],\n  \"type\": \"Implementation\"\n}",
)

Response

Project status created successfully