Query: Find or Create Task

Google Tasks Operation

The Find or Create Task query locates an existing task or creates a new one if it doesn't exist.

Example User Story

I want to find an existing task by its title or create a new one if it doesn't exist, so that I can manage my tasks efficiently.

Fields

Field Name	Field Type	Required
title	String	Yes
taskList	String	Yes
notes	String	No
due	String	No

Related Connections

Google Tasks

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "find-or-create-task",
  "state": "inDev",
  "meta": {
    "short": "Find or Create Task",
    "description": "Finds an existing task by title or creates a new one if it doesn't exist."
  },
  "input": [
    {
      "name": "title",
      "type": "String",
      "required": true,
      "meta": {
        "description": "Title of the task to find or create."
      }
    },
    {
      "name": "taskList",
      "type": "String",
      "required": true,
      "meta": {
        "description": "ID of the task list where the task should be found or created."
      }
    },
    {
      "name": "notes",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Additional notes for the task."
      }
    },
    {
      "name": "due",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Due date for the task in RFC 3339 format."
      }
    }
  ],
  "output": [
    {
      "name": "taskId",
      "type": "String",
      "selector": ["id"],
      "meta": {
        "description": "ID of the found or created task."
      }
    },
    {
      "name": "taskStatus",
      "type": "String",
      "selector": ["status"],
      "meta": {
        "description": "Status of the task (e.g., 'needsAction', 'completed')."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "GET",
        "path": "/tasks",
        "queryParams": {
          "tasklist": "{{taskList}}",
          "showCompleted": "false",
          "showHidden": "false"
        }
      }
    },
    {
      "type": "taq",
      "taq": {
        "action": "if",
        "condition": "{{#if (eq (len .response.tasks) 0)}}",
        "steps": [
          {
            "type": "http",
            "http": {
              "method": "POST",
              "path": "/tasks",
              "queryParams": {
                "tasklist": "{{taskList}}"
              },
              "bodyTemplate": {
                "value": "{\"title\": \"{{title}}\", \"notes\": \"{{notes}}\", \"due\": \"{{due}}\"}",
                "placeholders": [
                  {
                    "name": "title",
                    "type": "String",
                    "description": "Title of the task.",
                    "required": true
                  },
                  {
                    "name": "notes",
                    "type": "String",
                    "description": "Additional notes for the task.",
                    "required": false
                  },
                  {
                    "name": "due",
                    "type": "String",
                    "description": "Due date for the task in RFC 3339 format.",
                    "required": false
                  }
                ]
              }
            }
          }
        ]
      }
    }
  ]
}