Method: tasks.insert

Creates a new task on the specified task list. Tasks assigned from Docs or Chat Spaces cannot be inserted from Tasks Public API; they can only be created by assigning them from Docs or Chat Spaces. A user can have up to 20,000 non-hidden tasks per list and up to 100,000 tasks in total at a time.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Task list identifier.

Query parameters



Parent task identifier. If the task is created at the top level, this parameter is omitted. An assigned task cannot be a parent task, nor can it have a parent. Setting the parent to an assigned task results in failure of the request. Optional.



Previous sibling task identifier. If the task is created at the first position among its siblings, this parameter is omitted. Optional.

Request body

The request body contains an instance of Task.

Response body

If successful, the response body contains a newly created instance of Task.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authorization guide.