FAfactorialhr
ProjectManagement > Subproject

Creates a Subproject

Changed on
What does it do?

This creates a new subproject.

Is it related to other entities?

A subproject is always related to a project.

Who can use it?

Only companies who have enabled the projects_with_subprojects feature and users with a role in the project owning the subproject.

post/api/2026-10-01/resources/project_management/subprojects

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/project_management/subprojects
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: project_management_projects
    • or API key in header x-api-key

Request body

namestring required
project_idstring required

Response

CREATED

idstring

The id of the subproject

namestring required

The name of the subproject

project_idstring required

The id of the project

inputed_minutesinteger

The total minutes tracked in the subproject (if requested)

labor_cost_centsinteger

The total labor cost of the subproject in cents (if requested)

descriptionstring

The description of the subproject

status'active' | 'closed' | 'draft' | 'processing' required

The status of the subproject

codestring

The code of the subproject

start_datestring

The start date of the subproject

due_datestring

The due date of the subproject

is_billableboolean

Whether the subproject is billable

Example response

{
  "id": "314",
  "name": "Subproject name",
  "project_id": "11",
  "labor_cost_cents": 540000,
  "description": "Subproject description",
  "status": "active",
  "code": "SUB123",
  "start_date": "2025-01-01",
  "due_date": "2025-12-31",
  "is_billable": true
}

Changes