Create Time Tracking Project (Legacy)

Changed on Nov 3, 2026

Deprecated. Use Create Time Tracking Project instead (create-time-tracking-project).

Creates a time tracking project using the legacy contract and returns the project with its tasks. If a deleted project with the same name exists, that project is restored and updated with the supplied values instead of a new project being created; the response returns the restored project's existing ID.

OAuth Scopes: time_tracking.write

post/api/v1/time_tracking/projects

Request

Base URL
https://companySubDomain.bamboohr.com
Auth
OAuth 2
Authorization code/authorize.php
Token URL/token.php
Scopestime_tracking.write
TypeScript
https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/time_tracking/projects/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

namestring required

Name of the project. Must be unique and no more than 50 characters.

billableboolean

Indicates if the project is billable. Defaults to true if not provided.

includeInPayrollboolean

Indicates if project time is included in payroll. Defaults to false if not provided.

allowAllEmployeesboolean

Indicates if all employees can log time for this project. Defaults to true if not provided.

employeeIdsinteger[]

A list of internal employee IDs that can log time for this project. Only used when allowAllEmployees is false.

hasTasksboolean

Indicates if the project has tasks. Defaults to false if not provided.

Example request

{
  "name": "Project A"
}

Response

The created or restored project with its tasks. The employeeIds field is present only when one or more employees are individually assigned.

idinteger required

ID of the project.

namestring required

Name of the project.

employeeIdsinteger[]

Internal employee IDs that can log time for this project. Omitted when no employees are individually assigned; this does not by itself mean all employees have access.

Changes

Nov 3, 2026922fc15f43a7 Revision changes
- breaking
  the request property's minLength was increased from 0 to 1
- breaking
  the // request property's minLength was increased from 0 to 1
- breaking
  removed the media type application/json for the response with the status
- warning
  the // request property's maxLength was set to 50
- warning
  the / request property's min was set to 1.00
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  api operation id create-time-tracking-project removed and replaced with create-time-tracking-project-legacy
- info
  the endpoint scheme security basic was removed from the API
- info
  endpoint deprecated
- info
  added the new optional request property
- info
  the request property default value true was added
- info
  the request property default value true was added
- info
  the request property default value true was added
- info
  the request property default value false was added
- info
  added the media type application/problem+json for the response with the status
- info
  added the non-success response with the status
- info
  removed the non-success response with the status
- info
  removed the non-success response with the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history