FAfactorialhr
ProjectManagement > ProjectTask

Creates a Project task

Changed on
What does it do?

This creates a new project task. It will also create a new normal task in the system linked with the project task.

Who can use it?

Only companies who have enabled the projects_management feature and users with the permission of create projects.

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

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/project_management/project_tasks
  • 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 multipart/form-data

namestring required

The name of the project task

contentstring

The content/description of the project task

starts_onstring

The date when the project task starts

follow_upboolean

If true, status changes related to the project will notify the author

due_onstring

The date when the project task will be due

assignee_employee_ids[]string[]

The value of the assignee employee ids of the project task

project_idstring required

The ID of the project where the task belongs

subproject_idstring

The ID of the subproject where the project task belongs

files[]string[]

Array of files that will be attached to the project task

status'todo' | 'in_progress' | 'done' | 'discarded' required

The status of the project task

Example request

{
  "name": "Complete project documentation",
  "content": "Write comprehensive documentation for the new feature",
  "starts_on": "2024-01-15",
  "follow_up": true,
  "due_on": "2024-02-01",
  "assignee_employee_ids[]": [
    "15"
  ],
  "project_id": "123",
  "subproject_id": "456",
  "status": "todo"
}

Response

CREATED

idstring required
project_idstring required

The ID of the project linked to the project task

subproject_idstring

The ID of the subproject linked to the project task

task_idstring required

The ID of the task linked to the project task

follow_upboolean required

If true, status changes related to the project will notify the author

Example response

{
  "id": "789",
  "project_id": "123",
  "subproject_id": "456",
  "task_id": "780",
  "follow_up": true
}

Changes