Google Tasks

Version Latest

This is the documentation for the new Google Tasks app.
Here is the documentation for the legacy Google Tasks (legacy) app.

The Google Tasks modules enable you to monitor, retrieve, create, update, or delete tasks and task lists in your Google Tasks.

Getting Started with Google Tasks

Prerequisites

A Google account

In order to use Google Tasks with Integromat, it is necessary to have a Google Tasks account. If you do not have one, you can create a Google Tasks account at Google Tasks.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Google Tasks to Integromat

To connect your Google Tasks account to Integromat follow the general instructions for Connecting to services.

After you click the Continue button, Integromat will redirect you to the Google Tasks website where you will be prompted to grant Integromat access to your account.

Confirm the dialog by clicking the Allow button.

Task

Watch Tasks

Retrieves task details when a task is created and updated, due, or completed.

Connection	Establish a connection to your Google account.
Watch Tasks	Select the change that will return the tasks.
Show Completed Tasks	Enable this option to include also completed tasks in the module's output.
Task List ID	Select the task list you want to watch for changes.
Limit	Set the maximum number of tasks Integromat will return during one execution cycle.

List Tasks

Retrieves tasks in the specified task list by the filter settings.

Connection	Establish a connection to your Google account.
Task List ID	Map the task list ID or select the task list you want to retrieve tasks from.
To Completed Date	Enter the upper bound for a task's completion date to filter by. The list of supported date and time formats.
To Completed Date	Enter the lower bound for a task's completion date to filter by. The list of supported date and time formats.
From Due Date	Enter the exclusive upper bound for a task's due date to filter by. The list of supported date and time formats.
To Due Date	Enter inclusive lower bound for a task's due date to filter by. Filtering is by date only; hours and minutes are not used. The list of supported date and time formats.
Show Completed Tasks	Enable this option to include also completed tasks in the module's output.
Show Deleted Tasks	Enable this option to include deleted tasks in the module's output.
From Updated Time	Enter the lower bound for a task's last modification time to filter by. The list of supported date and time formats.
Limit	Set the maximum number of tasks Integromat will return during one execution cycle.

Get a Task

Retrieves task details.

Connection	Establish a connection to your Google account.
Task List ID	Map the Task List ID or select the task list you want to retrieve the task from.
Task ID	Map or select the ID of the task you want to retrieve details about.

Create a Task

Creates a new task in the specified task list.

Connection	Establish a connection to your Google account.
Task List ID	Map the Task List ID or select the task list you want to create a new task for.
Select the Method	Select whether you want to create a task or subtask.
Parent Task	Select the parent task of the new subtask.
Title	Enter the title for the new task.
Notes	Enter the notes describing the task.
Due Date	Enter the due date of the task. The list of supported date and time formats.

Update a Task

Updates an existing task.

Connection	Establish a connection to your Google account.
Task List ID	Map the Task List ID or select the task list you want to update a task for.
Task	Map the Task ID or select the task you want to update.
Title	Enter the new title for the task.
Notes	Enter the notes describing the task.
Due Date	Enter the due date of the task. The list of supported date and time formats.
Complete Task	Enable this option to mark the task as completed.

Delete a Task

Deletes an existing task.

Connection	Establish a connection to your Google account.
Task List ID	Map the Task List ID or select the task list that contains the task you want to delete.
Task	Map the Task ID or select the task you want to delete.

Task Lists

Watch Task Lists

Retrieve task list details when a task list is created or updated.

Connection	Establish a connection to your Google account.
Limit	Set the maximum number of tasks lists Integromat will return during one execution cycle.

List Task Lists

Retrieves all tasks lists in your account.

Connection	Establish a connection to your Google account.
Limit	Set the maximum number of tasks lists Integromat will return during one execution cycle.

Get a Task List

Retrieves task list details.

Connection	Establish a connection to your Google account.
Task List ID	Map the Task List ID or select the task list you want to retrieve details about.

Create a Task List

Creates a new task list in your account.

The maximum number of 2000 task lists is allowed.

Connection	Establish a connection to your Google account.
Title	Enter the title of the task list.

Update a Task List

Updates the title of an existing task list.

Connection	Establish a connection to your Google account.
Task List ID	Map the Task List ID or select the task list you want to update.
Title	Enter the new title for the task list.

Delete a Task List

Deletes a task list.

Connection	Establish a connection to your Google account.
Task List ID	Map the task list ID or select the task list you want to delete.

Other

Make an API Call

Allows you to perform a custom API call.

Connection	Establish a connection to your Google account.
URL	Enter a path relative to `https://www.googleapis.com/tasks`. E.g.`/v1/users/@me/lists` For the list of available endpoints, refer to the Google Tasks API Documentation.
Method	Select the HTTP method you want to use: GET to retrieve information for an entry. POST to create a new entry. PUT to update/replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry.
Headers	Enter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query String	Enter the request query string.
Body	Enter the body content for your API call.