- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
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
POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
tasklist |
Task list identifier. |
Query parameters
| Parameters | |
|---|---|
parent |
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 |
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:
https://www.googleapis.com/auth/tasks
For more information, see the Authorization guide.