Zoho Projects

Project management from Zoho. Create and update projects, task lists and tasks, assign owners, track progress and comment on tasks.

Actions

Action	What it does
Add a task comment	Add a comment to a task.
Create a project	Create a project with a name and an owner, and optionally a description, dates and visibility.
Create a task	Create a task, or a subtask of another task, with optional description, priority, dates, progress and owners.
Create a task list	Create a task list in a project.
Delete a task	Permanently delete a task from a project.
Delete a task list	Permanently delete a task list from a project.
Get a project	Get a project: its dates, owner, status, progress and open and closed task counts.
Get a task	Get a task: its status, priority, dates, progress, owners and task list.
List portal users	List the users of a portal.
List portals	List the Zoho Projects portals the connected user belongs to, with each portal's id and plan.
List project users	List the members of a project.
List projects	List the projects in a portal, optionally by name.
List task comments	List the comments on a task.
List task lists	List the task lists in a project.
List tasks	List a project's tasks, optionally only open ones.
Move a project to the recycle bin	Move a project to the recycle bin.
Permanently delete a project	Permanently delete a project that is already in the recycle bin, with all its task lists and tasks.
Update a project	Change a project's name, description, dates, visibility or owner, or archive or reactivate it.
Update a task	Change a task's name, description, priority, dates or progress, or move it to another task list.
Update a task list	Rename a task list, change its visibility, or mark it completed or active.

Add a task comment

Add a comment to a task.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
Task IDtask_idtextRequired: The task's id, from 'List tasks' or an earlier step.
CommentcommenttextRequired: The comment text.

Outputs

A task comment.

added_viatext: Where the comment was added from.
commenttext: The comment text (may contain HTML).
created_byobject: A Zoho Projects user.
created_timetext: When the comment was added.
idtext: The comment id.
updated_timetext: When the comment was last changed.

Example output

{
  "comment": "Draft is in the shared folder.",
  "created_by": {
    "email": "ada@example.com",
    "name": "Ada Lovelace",
    "zpuid": "1752587000000084001"
  },
  "created_time": "2026-09-30T10:00:00.000Z",
  "id": "1752587000000097061"
}

Create a project

Create a project with a name and an owner, and optionally a description, dates and visibility. A Free portal holds at most 3 projects.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
NamenametextRequired: The project name, up to 200 characters.
Ownerowner_zpuidtextRequired: The portal user who owns the project.
Descriptiondescriptiontext: Optional. The description.
Start datestart_datedate: Optional. When the project starts.
End dateend_datedate: Optional. When the project ends.
Public projectis_public_projecttrue/false: Optional. Whether every portal user can see the project.

Outputs

A Zoho Projects project.

completed_timetext: When the project was completed.
created_byobject: A Zoho Projects user.
created_timetext: When the project was created.
descriptiontext: The project description (may contain HTML).
end_datetext: End date.
idtext: The project id.
is_completedtrue/false: Whether the project is completed.
is_public_projecttrue/false: Whether the project is public within the portal.
issuesobject: Open and closed counts.
keytext: The project's short key.
milestonesobject: Open and closed counts.
modified_timetext: When the project was last changed.
nametext: The project name.
ownerobject: A Zoho Projects user.
percent_completenumber: How complete the project is, in percent.
project_typetext: active, template or archived.
start_datetext: Start date.
statusobject: The status.
tasksobject: Open and closed counts.

Example output

{
  "created_time": "2026-09-30T09:00:00.000Z",
  "description": "Everything for the autumn relaunch.",
  "end_date": "2026-12-15",
  "id": "1752587000000097005",
  "is_completed": false,
  "is_public_project": false,
  "key": "LD1",
  "name": "Website relaunch",
  "owner": {
    "email": "ada@example.com",
    "name": "Ada Lovelace",
    "zpuid": "1752587000000084001"
  },
  "percent_complete": 0,
  "project_type": "active",
  "start_date": "2026-10-01",
  "status": {
    "id": "1752587000000016071",
    "is_closed_type": false,
    "name": "Active"
  },
  "tasks": {
    "closed_count": 0,
    "open_count": 1
  }
}

Create a task

Create a task, or a subtask of another task, with optional description, priority, dates, progress and owners.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
NamenametextRequired: The task's name.
Task listtasklist_idtext: Optional. The task list to put the task in; Zoho's general list if empty.
Parent task IDparent_task_idtext: Optional. Make this a subtask of the task with this id.
Descriptiondescriptiontext: Optional. The description.
Priorityprioritytext: Optional. The task's priority.One of: none, low, medium, high.
Startstart_datedate and time: Optional. When work on the task starts.
Dueend_datedate and time: Optional. When the task is due.
Percent completecompletion_percentagenumber: Optional. How complete the task is, 0 to 100.From 0 to 100.
Ownersowner_zpuidslist: Optional. The project members who own the task.

Outputs

A task.

completion_percentagenumber: How complete the task is, in percent.
created_byobject: A Zoho Projects user.
created_timetext: When the task was created.
descriptiontext: The task description (may contain HTML).
end_datetext: Due date and time.
idtext: The task id.
is_completedtrue/false: Whether the task is completed.
last_modified_timetext: When the task was last changed.
milestoneobject: The milestone.
nametext: The task name.
owners_and_workobject: Who owns the task.
prefixtext: The task's short key, for example LP-T12.
prioritytext: none, low, medium or high.
projectobject: The project.
start_datetext: Start date and time.
statusobject: The status.
tasklistobject: The task list.

Example output

{
  "completion_percentage": 0,
  "end_date": "2026-10-03T17:00:00.000Z",
  "id": "1752587000000097041",
  "is_completed": false,
  "name": "Write release notes",
  "owners_and_work": {
    "owners": [
      {
        "email": "ada@example.com",
        "name": "Ada Lovelace",
        "zpuid": "1752587000000084001"
      }
    ]
  },
  "prefix": "LD1-T1",
  "priority": "medium",
  "project": {
    "id": "1752587000000097005",
    "name": "Website relaunch"
  },
  "start_date": "2026-10-01T09:00:00.000Z",
  "status": {
    "id": "1752587000000016068",
    "is_closed_type": false,
    "name": "Open"
  },
  "tasklist": {
    "id": "1752587000000097021",
    "name": "Launch checklist"
  }
}

Create a task list

Create a task list in a project.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
NamenametextRequired: The task list's name.
Visibilityflagtext: Optional. Internal lists are hidden from client users.One of: internal, external.

Outputs

A task list.

colortext: The task list colour.
created_byobject: A Zoho Projects user.
created_timetext: When the task list was created.
flagtext: internal or external.
idtext: The task list id.
last_updated_timetext: When the task list was last changed.
milestoneobject: The milestone.
nametext: The task list name.
statustext: active or completed.

Example output

{
  "created_time": "2026-09-30T09:05:00.000Z",
  "flag": "internal",
  "id": "1752587000000097021",
  "name": "Launch checklist",
  "status": "active"
}

Delete a task

Permanently delete a task from a project.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
Task IDtask_idtextRequired: The task's id, from 'List tasks' or an earlier step.

Outputs

The record deleted.

deletedtrue/false: Always true.
idtext: The deleted record's id.

Example output

{
  "deleted": true,
  "id": "1752587000000097041"
}

Delete a task list

Permanently delete a task list from a project. Zoho does not document what happens to the tasks in it, so move any you want to keep first.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
Task listtasklist_idtextRequired: The task list, from the list or as its id from 'List task lists'.

Outputs

The record deleted.

deletedtrue/false: Always true.
idtext: The deleted record's id.

Example output

{
  "deleted": true,
  "id": "1752587000000097021"
}

Get a project

Get a project: its dates, owner, status, progress and open and closed task counts.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.

Outputs

A Zoho Projects project.

completed_timetext: When the project was completed.
created_byobject: A Zoho Projects user.
created_timetext: When the project was created.
descriptiontext: The project description (may contain HTML).
end_datetext: End date.
idtext: The project id.
is_completedtrue/false: Whether the project is completed.
is_public_projecttrue/false: Whether the project is public within the portal.
issuesobject: Open and closed counts.
keytext: The project's short key.
milestonesobject: Open and closed counts.
modified_timetext: When the project was last changed.
nametext: The project name.
ownerobject: A Zoho Projects user.
percent_completenumber: How complete the project is, in percent.
project_typetext: active, template or archived.
start_datetext: Start date.
statusobject: The status.
tasksobject: Open and closed counts.

Example output

{
  "created_time": "2026-09-30T09:00:00.000Z",
  "description": "Everything for the autumn relaunch.",
  "end_date": "2026-12-15",
  "id": "1752587000000097005",
  "is_completed": false,
  "is_public_project": false,
  "key": "LD1",
  "name": "Website relaunch",
  "owner": {
    "email": "ada@example.com",
    "name": "Ada Lovelace",
    "zpuid": "1752587000000084001"
  },
  "percent_complete": 0,
  "project_type": "active",
  "start_date": "2026-10-01",
  "status": {
    "id": "1752587000000016071",
    "is_closed_type": false,
    "name": "Active"
  },
  "tasks": {
    "closed_count": 0,
    "open_count": 1
  }
}

Get a task

Get a task: its status, priority, dates, progress, owners and task list.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
Task IDtask_idtextRequired: The task's id, from 'List tasks' or an earlier step.

Outputs

A task.

completion_percentagenumber: How complete the task is, in percent.
created_byobject: A Zoho Projects user.
created_timetext: When the task was created.
descriptiontext: The task description (may contain HTML).
end_datetext: Due date and time.
idtext: The task id.
is_completedtrue/false: Whether the task is completed.
last_modified_timetext: When the task was last changed.
milestoneobject: The milestone.
nametext: The task name.
owners_and_workobject: Who owns the task.
prefixtext: The task's short key, for example LP-T12.
prioritytext: none, low, medium or high.
projectobject: The project.
start_datetext: Start date and time.
statusobject: The status.
tasklistobject: The task list.

Example output

{
  "completion_percentage": 0,
  "end_date": "2026-10-03T17:00:00.000Z",
  "id": "1752587000000097041",
  "is_completed": false,
  "name": "Write release notes",
  "owners_and_work": {
    "owners": [
      {
        "email": "ada@example.com",
        "name": "Ada Lovelace",
        "zpuid": "1752587000000084001"
      }
    ]
  },
  "prefix": "LD1-T1",
  "priority": "medium",
  "project": {
    "id": "1752587000000097005",
    "name": "Website relaunch"
  },
  "start_date": "2026-10-01T09:00:00.000Z",
  "status": {
    "id": "1752587000000016068",
    "is_closed_type": false,
    "name": "Open"
  },
  "tasklist": {
    "id": "1752587000000097021",
    "name": "Launch checklist"
  }
}

List portal users

List the users of a portal. Each user's id is the one to use as a project or task owner.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
User typeuser_typetext: Optional. Which kind of user to list; portal users if empty.One of: portal_user (Portal user), client_user (Client user), client_contact (Client contact).
Statusview_typetext: Optional. Active or inactive users; active if empty.One of: active, inactive.
Pagepagenumber: Optional. Which page to return, starting at 1.At least 1.
Page sizeper_pagenumber: Optional. How many to return per page, 1 to 200. Zoho's default is 100.From 1 to 200.

Outputs

countnumber: How many users are on this page.
has_moretrue/false: Whether another page is available (pass page + 1).
itemslist: The users.
pagenumber: The page number returned.
per_pagenumber: The page size used.

Example output

{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "email": "ada@example.com",
      "first_name": "Ada",
      "full_name": "Ada Lovelace",
      "id": "1752587000000084001",
      "is_confirmed": true,
      "last_name": "Lovelace",
      "status": "active",
      "zuid": "80012345"
    }
  ],
  "page": 1,
  "per_page": 100
}

List portals

List the Zoho Projects portals the connected user belongs to, with each portal's id and plan.

Inputs

None.

Outputs

countnumber: How many portals are on this page.
has_moretrue/false: Whether another page is available (pass page + 1).
itemslist: The portals.
pagenumber: The page number returned.
per_pagenumber: The page size used.

Example output

{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "id": "60012345678",
      "is_default_portal": true,
      "org_name": "Lodol Demo",
      "portal_name": "lodoldemo",
      "project_plan": "Free",
      "timezone": "Europe/London"
    }
  ],
  "page": 1,
  "per_page": 100
}

List project users

List the members of a project. Each user's id is the one to use as a task owner.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
User typeuser_typetext: Optional. Which kind of user to list; portal users if empty.One of: portal_user (Portal user), client_user (Client user), client_contact (Client contact).
Statusview_typetext: Optional. Active or inactive users; active if empty.One of: active, inactive.
Pagepagenumber: Optional. Which page to return, starting at 1.At least 1.
Page sizeper_pagenumber: Optional. How many to return per page, 1 to 200. Zoho's default is 100.From 1 to 200.

Outputs

countnumber: How many users are on this page.
has_moretrue/false: Whether another page is available (pass page + 1).
itemslist: The users.
pagenumber: The page number returned.
per_pagenumber: The page size used.

Example output

{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "email": "ada@example.com",
      "first_name": "Ada",
      "full_name": "Ada Lovelace",
      "id": "1752587000000084001",
      "is_confirmed": true,
      "last_name": "Lovelace",
      "status": "active",
      "zuid": "80012345"
    }
  ],
  "page": 1,
  "per_page": 100
}

List projects

List the projects in a portal, optionally by name.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Name containsname_containstext: Optional. Only projects whose name contains this.
Ordersort_bytext: Optional. The order to return projects in.One of: ASC(name) (Name, A to Z), DESC(created_time) (Newest first), ASC(start_date) (Start date, earliest first).
Pagepagenumber: Optional. Which page to return, starting at 1.At least 1.
Page sizeper_pagenumber: Optional. How many to return per page, 1 to 200. Zoho's default is 100.From 1 to 200.

Outputs

countnumber: How many projects are on this page.
has_moretrue/false: Whether another page is available (pass page + 1).
itemslist: The projects.
pagenumber: The page number returned.
per_pagenumber: The page size used.

Example output

{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "created_time": "2026-09-30T09:00:00.000Z",
      "description": "Everything for the autumn relaunch.",
      "end_date": "2026-12-15",
      "id": "1752587000000097005",
      "is_completed": false,
      "is_public_project": false,
      "key": "LD1",
      "name": "Website relaunch",
      "owner": {
        "email": "ada@example.com",
        "name": "Ada Lovelace",
        "zpuid": "1752587000000084001"
      },
      "percent_complete": 0,
      "project_type": "active",
      "start_date": "2026-10-01",
      "status": {
        "id": "1752587000000016071",
        "is_closed_type": false,
        "name": "Active"
      },
      "tasks": {
        "closed_count": 0,
        "open_count": 1
      }
    }
  ],
  "page": 1,
  "per_page": 100
}

List task comments

List the comments on a task.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
Task IDtask_idtextRequired: The task's id, from 'List tasks' or an earlier step.
Ordersort_bytext: Optional. Newest or oldest first.One of: DESC(created_time) (Newest first), ASC(created_time) (Oldest first).
Pagepagenumber: Optional. Which page to return, starting at 1.At least 1.
Page sizeper_pagenumber: Optional. How many to return per page, 1 to 200. Zoho's default is 100.From 1 to 200.

Outputs

countnumber: How many comments are on this page.
has_moretrue/false: Whether another page is available (pass page + 1).
itemslist: The comments.
pagenumber: The page number returned.
per_pagenumber: The page size used.

Example output

{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "comment": "Draft is in the shared folder.",
      "created_by": {
        "email": "ada@example.com",
        "name": "Ada Lovelace",
        "zpuid": "1752587000000084001"
      },
      "created_time": "2026-09-30T10:00:00.000Z",
      "id": "1752587000000097061"
    }
  ],
  "page": 1,
  "per_page": 100
}

List task lists

List the task lists in a project.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
Ordersort_bytext: Optional. The order to return task lists in.One of: ASC(created_time) (Oldest first), DESC(created_time) (Newest first), DESC(last_modified_time) (Recently changed first).
Pagepagenumber: Optional. Which page to return, starting at 1.At least 1.
Page sizeper_pagenumber: Optional. How many to return per page, 1 to 200. Zoho's default is 100.From 1 to 200.

Outputs

countnumber: How many task lists are on this page.
has_moretrue/false: Whether another page is available (pass page + 1).
itemslist: The task lists.
pagenumber: The page number returned.
per_pagenumber: The page size used.

Example output

{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "created_time": "2026-09-30T09:05:00.000Z",
      "flag": "internal",
      "id": "1752587000000097021",
      "name": "Launch checklist",
      "status": "active"
    }
  ],
  "page": 1,
  "per_page": 100
}

List tasks

List a project's tasks, optionally only open ones. A task list, when chosen, filters the page Zoho returns.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
Task listtasklist_idtext: Optional. Only tasks in this task list.
Only open tasksonly_opentrue/false: Optional. Leave out tasks with a closed status.Default: false.
Ordersort_bytext: Optional. The order to return tasks in.One of: ASC(name) (Name, A to Z), DESC(created_time) (Newest first), DESC(last_modified_time) (Recently changed first), ASC(end_date) (Due date, earliest first).
Pagepagenumber: Optional. Which page to return, starting at 1.At least 1.
Page sizeper_pagenumber: Optional. How many to return per page, 1 to 200. Zoho's default is 100.From 1 to 200.

Outputs

countnumber: How many tasks are on this page.
has_moretrue/false: Whether another page is available (pass page + 1).
itemslist: The tasks.
pagenumber: The page number returned.
per_pagenumber: The page size used.

Example output

{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "completion_percentage": 0,
      "end_date": "2026-10-03T17:00:00.000Z",
      "id": "1752587000000097041",
      "is_completed": false,
      "name": "Write release notes",
      "owners_and_work": {
        "owners": [
          {
            "email": "ada@example.com",
            "name": "Ada Lovelace",
            "zpuid": "1752587000000084001"
          }
        ]
      },
      "prefix": "LD1-T1",
      "priority": "medium",
      "project": {
        "id": "1752587000000097005",
        "name": "Website relaunch"
      },
      "start_date": "2026-10-01T09:00:00.000Z",
      "status": {
        "id": "1752587000000016068",
        "is_closed_type": false,
        "name": "Open"
      },
      "tasklist": {
        "id": "1752587000000097021",
        "name": "Launch checklist"
      }
    }
  ],
  "page": 1,
  "per_page": 100
}

Move a project to the recycle bin

Move a project to the recycle bin. It can be restored from the recycle bin in Zoho Projects until it is deleted.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.

Outputs

The project moved to the recycle bin.

idtext: The project id.
trashedtrue/false: Always true.

Example output

{
  "id": "1752587000000097005",
  "trashed": true
}

Permanently delete a project

Permanently delete a project that is already in the recycle bin, with all its task lists and tasks. This cannot be undone. Move the project to the recycle bin first.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Project IDproject_idtextRequired: The id of the project in the recycle bin, for example from 'Move a project to the recycle bin'.

Outputs

The record deleted.

deletedtrue/false: Always true.
idtext: The deleted record's id.

Example output

{
  "deleted": true,
  "id": "1752587000000097005"
}

Update a project

Change a project's name, description, dates, visibility or owner, or archive or reactivate it. Only what you fill in changes.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
New namenametext: Optional. The new name, up to 200 characters.
Descriptiondescriptiontext: Optional. The description.
Start datestart_datedate: Optional. When the project starts.
End dateend_datedate: Optional. When the project ends.
Public projectis_public_projecttrue/false: Optional. Whether every portal user can see the project.
New ownerowner_zpuidtext: Optional. The portal user who should own the project.
Archive stateproject_typetext: Optional. Archive the project, or make it active again.One of: active, archived.

Outputs

A Zoho Projects project.

completed_timetext: When the project was completed.
created_byobject: A Zoho Projects user.
created_timetext: When the project was created.
descriptiontext: The project description (may contain HTML).
end_datetext: End date.
idtext: The project id.
is_completedtrue/false: Whether the project is completed.
is_public_projecttrue/false: Whether the project is public within the portal.
issuesobject: Open and closed counts.
keytext: The project's short key.
milestonesobject: Open and closed counts.
modified_timetext: When the project was last changed.
nametext: The project name.
ownerobject: A Zoho Projects user.
percent_completenumber: How complete the project is, in percent.
project_typetext: active, template or archived.
start_datetext: Start date.
statusobject: The status.
tasksobject: Open and closed counts.

Example output

{
  "created_time": "2026-09-30T09:00:00.000Z",
  "description": "Everything for the autumn relaunch.",
  "end_date": "2026-12-15",
  "id": "1752587000000097005",
  "is_completed": false,
  "is_public_project": false,
  "key": "LD1",
  "name": "Website relaunch",
  "owner": {
    "email": "ada@example.com",
    "name": "Ada Lovelace",
    "zpuid": "1752587000000084001"
  },
  "percent_complete": 0,
  "project_type": "active",
  "start_date": "2026-10-01",
  "status": {
    "id": "1752587000000016071",
    "is_closed_type": false,
    "name": "Active"
  },
  "tasks": {
    "closed_count": 0,
    "open_count": 1
  }
}

Update a task

Change a task's name, description, priority, dates or progress, or move it to another task list. Only what you fill in changes.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
Task IDtask_idtextRequired: The task's id, from 'List tasks' or an earlier step.
New namenametext: Optional. The task's new name.
Descriptiondescriptiontext: Optional. The description.
Priorityprioritytext: Optional. The task's priority.One of: none, low, medium, high.
Startstart_datedate and time: Optional. When work on the task starts.
Dueend_datedate and time: Optional. When the task is due.
Percent completecompletion_percentagenumber: Optional. How complete the task is, 0 to 100.From 0 to 100.
Move to task listtasklist_idtext: Optional. The task list to move the task to.

Outputs

A task.

completion_percentagenumber: How complete the task is, in percent.
created_byobject: A Zoho Projects user.
created_timetext: When the task was created.
descriptiontext: The task description (may contain HTML).
end_datetext: Due date and time.
idtext: The task id.
is_completedtrue/false: Whether the task is completed.
last_modified_timetext: When the task was last changed.
milestoneobject: The milestone.
nametext: The task name.
owners_and_workobject: Who owns the task.
prefixtext: The task's short key, for example LP-T12.
prioritytext: none, low, medium or high.
projectobject: The project.
start_datetext: Start date and time.
statusobject: The status.
tasklistobject: The task list.

Example output

{
  "completion_percentage": 0,
  "end_date": "2026-10-03T17:00:00.000Z",
  "id": "1752587000000097041",
  "is_completed": false,
  "name": "Write release notes",
  "owners_and_work": {
    "owners": [
      {
        "email": "ada@example.com",
        "name": "Ada Lovelace",
        "zpuid": "1752587000000084001"
      }
    ]
  },
  "prefix": "LD1-T1",
  "priority": "medium",
  "project": {
    "id": "1752587000000097005",
    "name": "Website relaunch"
  },
  "start_date": "2026-10-01T09:00:00.000Z",
  "status": {
    "id": "1752587000000016068",
    "is_closed_type": false,
    "name": "Open"
  },
  "tasklist": {
    "id": "1752587000000097021",
    "name": "Launch checklist"
  }
}

Update a task list

Rename a task list, change its visibility, or mark it completed or active. Only what you fill in changes.

Inputs

Portalportal_idtextRequired: The Zoho Projects portal (organisation) to work in.
Projectproject_idtextRequired: The project, from the list or as its id from 'List projects'.
Task listtasklist_idtextRequired: The task list, from the list or as its id from 'List task lists'.
New namenametext: Optional. The task list's new name.
Visibilityflagtext: Optional. Internal lists are hidden from client users.One of: internal, external.
Statusstatustext: Optional. Mark the task list completed or active.One of: active, completed.

Outputs

A task list.

colortext: The task list colour.
created_byobject: A Zoho Projects user.
created_timetext: When the task list was created.
flagtext: internal or external.
idtext: The task list id.
last_updated_timetext: When the task list was last changed.
milestoneobject: The milestone.
nametext: The task list name.
statustext: active or completed.

Example output

{
  "created_time": "2026-09-30T09:05:00.000Z",
  "flag": "internal",
  "id": "1752587000000097021",
  "name": "Launch checklist",
  "status": "active"
}

ActionsCopy Anchor Link

Add a task commentCopy Anchor Link

Inputs

Outputs

Create a projectCopy Anchor Link

Inputs

Outputs

Create a taskCopy Anchor Link

Inputs

Outputs

Create a task listCopy Anchor Link

Inputs

Outputs

Delete a taskCopy Anchor Link

Inputs

Outputs

Delete a task listCopy Anchor Link

Inputs

Outputs

Get a projectCopy Anchor Link

Inputs

Outputs

Get a taskCopy Anchor Link

Inputs

Outputs

List portal usersCopy Anchor Link

Inputs

Outputs

List portalsCopy Anchor Link

Inputs

Outputs

List project usersCopy Anchor Link

Inputs

Outputs

List projectsCopy Anchor Link

Inputs

Outputs

List task commentsCopy Anchor Link

Inputs

Outputs

List task listsCopy Anchor Link

Inputs

Outputs

List tasksCopy Anchor Link

Inputs

Outputs

Move a project to the recycle binCopy Anchor Link

Inputs

Outputs

Permanently delete a projectCopy Anchor Link

Inputs

Outputs

Update a projectCopy Anchor Link

Inputs

Outputs

Update a taskCopy Anchor Link

Inputs

Outputs

Update a task listCopy Anchor Link

Inputs

Outputs

On this page

Actions

Add a task comment

Create a project

Create a task

Create a task list

Delete a task

Delete a task list

Get a project

Get a task

List portal users

List portals

List project users

List projects

List task comments

List task lists

List tasks

Move a project to the recycle bin

Permanently delete a project

Update a project

Update a task

Update a task list