POST /v4/projects – Clockodo API Documentation

Absence5

AccessGroup5

AccessGroupAccess7

Clock4

Customer6

Entry5

EntryGroup3

EntryText1

Favorite6

HolidayCarryover5

HolidayQuota5

IndividualUserAccess8

LumpSumService5

NonbusinessDay5

NonbusinessGroup5

OvertimeCarry5

OvertimeReduction5

Project8

ProjectReport2

Rate7

Register1

Service5

Subproject6

Subscription1

TargetHour5

Team5

User8

UserNonbusinessDay1

UserNonbusinessGroup5

UserReport2

WorkTime6

Webhooks

Webhook47

Project

Changed on Apr 19, 2026

post/v4/projects

Request

Base URL
https://my.clockodo.com/api
URL
https://my.clockodo.com/api/v4/projects
Auth
- HTTP basic and API key in header X-Clockodo-External-Application
- or API key in header X-ClockodoApiUser and API key in header X-ClockodoApiKey and API key in header X-Clockodo-External-Application
- or OAuth 2
  Authorization code: /oauth/authorize
  Token URL: /token

Request body

namestring required

customers_idinteger required

activeboolean

numberstring nullable

Freely selectable number for the project

billable_defaultboolean

notestring nullable

deadlinestring date nullable

Date when the project will be completed automatically

start_datestring date nullable

Date when the project becomes available for time tracking

automatic_completionboolean

service_assignmentsinteger[]

bill_service_idstring nullable

Example request

{
  "deadline": "2023-02-28",
  "start_date": "2023-02-28"
}

Response

Successful operation

Example response

{
  "data": {
    "id": 10,
    "name": "Publicity campaign",
    "note": "This project is important for us",
    "completed_at": "2023-02-28T12:00:00Z",
    "deadline": "2023-02-28",
    "start_date": "2023-01-01",
    "count_subprojects": 5,
    "bill_service_id": "1234",
    "service_assignments": [
      10
    ]
  }
}

Changes

Apr 19, 2026a88d0ed986cf Revision changes
- breaking
  the / response property's maxLength was unset from 100 for the response status
- breaking
  the / response property's maxLength was unset from 1000 for the response status
- breaking
  the / response property's maxLength was unset from 50 for the response status
- breaking
  added subschema #2 to the / response property oneOf list for the response status
- breaking
  the / response's property type changed from object null to no type for status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  added the new AllSubprojectsMustBeCompleted enum value to the //// response property for the response status
- warning
  added the new BilledCanOnlyBeSetWithHourBudget enum value to the //// response property for the response status
- warning
  added the new BilledMoneyCanOnlyBeSetWithHardBudget enum value to the //// response property for the response status
- warning
  added the new BudgetIsRequiredForRetainerProject enum value to the //// response property for the response status
- warning
  added the new BudgetSourceIsNotChangedFromOrToIntervalWhenSubprojectsExist enum value to the //// response property for the response status
- warning
  added the new BudgetSourceIsNotChangedToIntervalWhenEntriesExist enum value to the //// response property for the response status
- warning
  added the new BudgetTotalBelowSubprojectBudgetSum enum value to the //// response property for the response status
- warning
  added the new CannotChangeBudgetCommitmentBecauseOfCompletedSubprojects enum value to the //// response property for the response status
- warning
  added the new CannotChangeBudgetTypeBecauseOfSubprojects enum value to the //// response property for the response status
- warning
  added the new CannotModifyDemoData enum value to the //// response property for the response status
- warning
  added the new CannotRemoveBudgetBecauseOfSubprojectBudgets enum value to the //// response property for the response status
- warning
  added the new CompletionIsForbiddenBySubprojectBudget enum value to the //// response property for the response status
- warning
  added the new CompletionIsForbiddenBySubprojectCompletion enum value to the //// response property for the response status
- warning
  added the new Empty enum value to the //// response property for the response status
- warning
  added the new FieldsShouldBeEmpty enum value to the //// response property for the response status
- warning
  added the new HasToBeInactive enum value to the //// response property for the response status
- warning
  added the new IllegalChangeForCompletedProject enum value to the //// response property for the response status
- warning
  added the new IntervalBudgetRequiresRetainerPlan enum value to the //// response property for the response status
- warning
  added the new IntervalChangeIsForbiddenForIntervalProjectsWithSubprojects enum value to the //// response property for the response status
- warning
  added the new ProjectCompletionAnyRunningEntries enum value to the //// response property for the response status
- warning
  added the new ProjectCompletionNoBillableEntries enum value to the //// response property for the response status
- warning
  added the new ProjectCompletionTooManyLumpSums enum value to the //// response property for the response status
- warning
  added the new ProjectDeadlineIsNotBeforeProjectStart enum value to the //// response property for the response status
- warning
  added the new ProjectPeriodCollidesWithSubprojectPeriods enum value to the //// response property for the response status
- warning
  added the new ProjectPeriodMustContainAllEntryStarts enum value to the //// response property for the response status
- warning
  added the new RelationsPreventDeletion enum value to the //// response property for the response status
- warning
  added the new ResourceConflictFound enum value to the //// response property for the response status
- warning
  added the new ResourceNotFound enum value to the //// response property for the response status
- warning
  added the new RunningEntriesPreventDeletion enum value to the //// response property for the response status
- warning
  added the new UnexpectedValue enum value to the //// response property for the response status
- warning
  added the new absences enum value to the ////// response property for the response status
- warning
  added the new absences enum value to the ////// response property for the response status
- warning
  added the new absences enum value to the ////// response property for the response status
- warning
  added the new access_groups enum value to the ////// response property for the response status
- warning
  added the new access_groups enum value to the ////// response property for the response status
- warning
  added the new access_groups enum value to the ////// response property for the response status
- warning
  added the new company enum value to the ////// response property for the response status
- warning
  added the new company enum value to the ////// response property for the response status
- warning
  added the new company enum value to the ////// response property for the response status
- warning
  added the new company_state enum value to the ////// response property for the response status
- warning
  added the new company_state enum value to the ////// response property for the response status
- warning
  added the new company_state enum value to the ////// response property for the response status
- warning
  added the new customers enum value to the ////// response property for the response status
- warning
  added the new customers enum value to the ////// response property for the response status
- warning
  added the new customers enum value to the ////// response property for the response status
- warning
  added the new customers_projects_access enum value to the ////// response property for the response status
- warning
  added the new customers_projects_access enum value to the ////// response property for the response status
- warning
  added the new customers_projects_access enum value to the ////// response property for the response status
- warning
  added the new entries enum value to the ////// response property for the response status
- warning
  added the new entries enum value to the ////// response property for the response status
- warning
  added the new entries enum value to the ////// response property for the response status
- warning
  added the new favorite enum value to the ////// response property for the response status
- warning
  added the new favorite enum value to the ////// response property for the response status
- warning
  added the new favorite enum value to the ////// response property for the response status
- warning
  added the new holidays_carry enum value to the ////// response property for the response status
- warning
  added the new holidays_carry enum value to the ////// response property for the response status
- warning
  added the new holidays_carry enum value to the ////// response property for the response status
- warning
  added the new holidays_quota enum value to the ////// response property for the response status
- warning
  added the new holidays_quota enum value to the ////// response property for the response status
- warning
  added the new holidays_quota enum value to the ////// response property for the response status
- warning
  added the new lumpsum_services enum value to the ////// response property for the response status
- warning
  added the new lumpsum_services enum value to the ////// response property for the response status
- warning
  added the new lumpsum_services enum value to the ////// response property for the response status
- warning
  added the new nonbusiness_days enum value to the ////// response property for the response status
- warning
  added the new nonbusiness_days enum value to the ////// response property for the response status
- warning
  added the new nonbusiness_days enum value to the ////// response property for the response status
- warning
  added the new nonbusiness_groups enum value to the ////// response property for the response status
- warning
  added the new nonbusiness_groups enum value to the ////// response property for the response status
- warning
  added the new nonbusiness_groups enum value to the ////// response property for the response status
- warning
  added the new overtime_carrys enum value to the ////// response property for the response status
- warning
  added the new overtime_carrys enum value to the ////// response property for the response status
- warning
  added the new overtime_carrys enum value to the ////// response property for the response status
- warning
  added the new project_reports enum value to the ////// response property for the response status
- warning
  added the new project_reports enum value to the ////// response property for the response status
- warning
  added the new project_reports enum value to the ////// response property for the response status
- warning
  added the new project_reports_meta_data enum value to the ////// response property for the response status
- warning
  added the new project_reports_meta_data enum value to the ////// response property for the response status
- warning
  added the new project_reports_meta_data enum value to the ////// response property for the response status
- warning
  added the new projects enum value to the ////// response property for the response status
- warning
  added the new projects enum value to the ////// response property for the response status
- warning
  added the new projects enum value to the ////// response property for the response status
- warning
  added the new rates enum value to the ////// response property for the response status
- warning
  added the new rates enum value to the ////// response property for the response status
- warning
  added the new rates enum value to the ////// response property for the response status
- warning
  added the new report_templates enum value to the ////// response property for the response status
- warning
  added the new report_templates enum value to the ////// response property for the response status
- warning
  added the new report_templates enum value to the ////// response property for the response status
- warning
  added the new reports enum value to the ////// response property for the response status
- warning
  added the new reports enum value to the ////// response property for the response status
- warning
  added the new reports enum value to the ////// response property for the response status
- warning
  added the new services enum value to the ////// response property for the response status
- warning
  added the new services enum value to the ////// response property for the response status
- warning
  added the new services enum value to the ////// response property for the response status
- warning
  added the new subprojects enum value to the ////// response property for the response status
- warning
  added the new subprojects enum value to the ////// response property for the response status
- warning
  added the new subprojects enum value to the ////// response property for the response status
- warning
  added the new surcharge_models enum value to the ////// response property for the response status
- warning
  added the new surcharge_models enum value to the ////// response property for the response status
- warning
  added the new surcharge_models enum value to the ////// response property for the response status
- warning
  added the new targethours enum value to the ////// response property for the response status
- warning
  added the new targethours enum value to the ////// response property for the response status
- warning
  added the new targethours enum value to the ////// response property for the response status
- warning
  added the new team enum value to the ////// response property for the response status
- warning
  added the new team enum value to the ////// response property for the response status
- warning
  added the new team enum value to the ////// response property for the response status
- warning
  added the new users enum value to the ////// response property for the response status
- warning
  added the new users enum value to the ////// response property for the response status
- warning
  added the new users enum value to the ////// response property for the response status
- warning
  added the new work_time_break_rules enum value to the ////// response property for the response status
- warning
  added the new work_time_break_rules enum value to the ////// response property for the response status
- warning
  added the new work_time_break_rules enum value to the ////// response property for the response status
- warning
  added the new work_time_regulations enum value to the ////// response property for the response status
- warning
  added the new work_time_regulations enum value to the ////// response property for the response status
- warning
  added the new work_time_regulations enum value to the ////// response property for the response status
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new 10.00 enum value to the request property //
- info
  added the new 20.00 enum value to the request property //
- info
  added the new 30.00 enum value to the request property //
- info
  added the new 40.00 enum value to the request property //
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added to the // response property anyOf list for the response status
- info
  removed from the // response property anyOf list for the response status
- info
  added the required property / to the response with the status
Jan 16, 2026e856eda71f64 Revision changes
- info
  added the new optional request property /
- info
  added the new optional request property
- info
  added the optional property / to the response with the status
- info
  added to the // response property anyOf list for the response status
- info
  removed from the // response property anyOf list for the response status

Operation history (3 revisions)