Tasklists: insert

Creates a new task list and adds it to the authenticated user's task lists. Fails with HTTP code 403 or 429 after reaching the storage limit of 2,000 lists. Try it now or see an example.

Request

HTTP request

POST https://www.googleapis.com/tasks/v1/users/@me/lists

Authorization

This request requires authorization with the following scope:

Scope
https://www.googleapis.com/auth/tasks

For more information, see the authentication and authorization page.

Request body

In the request body, supply a Tasklists resource.

Response

If successful, this method returns a Tasklists resource in the response body.

Examples

Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).

Java

Uses the Java client library.

TaskList taskList = new TaskList();
taskList.setTitle("New Task List");

TaskList result = service.tasklists.insert(taskList).execute();
System.out.println(result.getId());

PHP

Uses the PHP client library.

$tasklist = new TaskList();
$tasklist->setTitle('New Task List');

$result = $service->insertTasklists($tasklist);
echo $result->getTitle();

Python

Uses the Python client library.

tasklist = {
  'title': 'New Task List'
  }

result = service.tasklists().insert(body=tasklist).execute()
print result['id']

.NET

Uses the .NET client library.

TaskList list = new TaskList { Title = "New Task List" };
list = service.Tasklists.Insert(list).Fetch();
Console.WriteLine(list.Id);

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer.