Create Time Tracking Project Task

Creates a new task on the specified time tracking project.

OAuth Scopes: time_tracking:project.write

post/api/v1/time-tracking/projects/{projectId}/tasks

Request

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

Path parameters

projectIdstring required

The project ID.

Request body

namestring required

Display name of the task.

billableboolean nullable

Whether hours on this task are billable. Defaults to false when omitted.

Example request

{
  "name": "Client onboarding",
  "billable": true
}

Response

Task created.

idinteger

The ID of the task.

namestring

The name of the task.

projectIdinteger

The ID of the project this task belongs to.

billableboolean

Whether the task is billable.

createdAtstring date-time nullable

ISO 8601 timestamp when the task was created.

updatedAtstring date-time nullable

ISO 8601 timestamp when the task was last updated.

deletedAtstring date-time nullable

ISO 8601 timestamp when the task was deleted.

Example response

{
  "id": 1,
  "name": "Task A",
  "projectId": 1,
  "createdAt": "2025-10-15T16:00:00Z",
  "updatedAt": "2025-10-15T16:00:00Z",
  "deletedAt": "2025-10-15T16:00:00Z"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.