Googletasks Insert Task

Unique identifier for the task. Generated by Google Tasks API when creating a task. Used for updating or deleting existing tasks.

Due date for the task (optional). NOTE: Google Tasks only stores the date portion (YYYY-MM-DD) - any time component provided will be automatically stripped before sending to the API. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically…

ETag of the resource for concurrency control. Prevents accidental overwrites when multiple clients modify the same task. Auto-generated by the API.

Additional details or description for the task. Supports plain text only (no HTML/markdown). Maximum 8192 characters. Example: 'Include Q3 sales data and projections'

Title/name of the task (REQUIRED). This is the main text displayed for the task. Maximum 1024 characters. Example: 'Complete quarterly report'

Whether the task is hidden from the default view. Hidden tasks can still be accessed via API but won't show in UI. Default: false

Status of the task. Must be either 'needsAction' (task is pending) or 'completed' (task is done). Defaults to 'needsAction' if not provided.

Whether the task has been deleted. Deleted tasks are marked but not immediately removed, allowing for recovery. Default: false

Date/time when the task was marked as completed. Only applicable when status='completed'. Unlike 'due', this field preserves the time component. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable format…

Identifier of an existing task to serve as parent; if provided, creates a subtask, otherwise a top-level task in the specified list.

Task list identifier where the new task will be created. Valid values: (1) '@default' - special identifier that references the user's default/primary task list, or (2) an actual task list ID obtained from the 'List Task Lists' action (GOOGLETASKS_LIST_TASK_LISTS). Task list IDs…

Identifier of an existing task after which the new task will be placed, at the same hierarchical level (as a sibling).