Method: tasks.insert

Creates a new task on the specified task list. A user can have up to 20,000 uncompleted 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

string

Task list identifier.

Query parameters

Parameters
parent

string

Parent task identifier. If the task is created at the top level, this parameter is omitted. Optional.

previous

string

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.