# Add Task

> The Add Task action lets you automatically create new tasks with multiple parameters and custom fields inside projects as part of your automation flo...

- Source: https://www.taskade.com/learn/automation/add-task
- Section: Automation
- Updated: 2026-11-09
- Index of all pages: https://www.taskade.com/learn/llms.txt

## Overview

The Add Task action lets you automatically create new tasks with multiple parameters and custom fields inside projects as part of your automations. It is the **workhorse action of every Taskade automation**: how a [Webhook](https://www.taskade.com/learn/automation/webhooks), [Mailhook](https://www.taskade.com/learn/automation/mailhook), [Form](https://www.taskade.com/learn/automation/forms-trigger), or [Schedule](https://www.taskade.com/learn/automation/schedule) trigger turns external events into structured work.

> **TL;DR:** The Add Task action runs as a step inside an automation and writes new tasks, complete with content, due dates, and custom fields, straight into a project. Set **Match by** to update the matching task instead of adding a duplicate. It is how a [trigger](https://www.taskade.com/learn/automation/triggers) turns an incoming event into structured work.

```mermaid
flowchart LR
  A[Trigger fires] --> B[Automation runs]
  B --> C[Add Task action]
  C --> D[Task written to project]
  style A fill:#0d1b2a,color:#7dd3fc,stroke:#38bdf8,stroke-width:1.5px
  style B fill:#2a1225,color:#ff8fa3,stroke:#ff2d60,stroke-width:2px
  style C fill:#2a1225,color:#ff8fa3,stroke:#ff2d60,stroke-width:2px
  style D fill:#0d1a0e,color:#86efac,stroke:#22c55e,stroke-width:1.5px
```

![](https://www.taskade.com/static_images/learn/automation/add-task-7a472bf4.jpg)

---

## Add Task Actions

Here are the [triggers](https://www.taskade.com/learn/automation/triggers) & [actions](https://www.taskade.com/learn/automation/actions) you can use in your automations:

| (ACTION) Add Task | Adds a task with additional parameters and custom fields to a specific project. |
| --- | --- |

---

## Add Task Automation Settings

You can configure several fields of the Add Task action:

| Field | Description |
| --- | --- |
| PROJECT | The ID of the project where you want to add the new task. |
| BLOCK | The ID of the block where you want to add the task inside a project. |
| CONTENT | The content of the task. |
| POSITION | Position of the new task in a project. |
| FIELDS | Custom fields that will be added to a project together with the task. |
| DUE DATE | The due date for the task. |
| END DATE | Optional. The end of a date range that starts at the due date. Leave it empty for a single due date. |
| ASSIGNEE | The project member to assign the new task to. Leave it empty to add the task unassigned. |
| MATCH BY | Optional. Update the existing task instead of adding a duplicate. Pick **Task content**, or a text or number custom field of the project. Leave it empty to always add a new task. |

---

## Update the Matching Task Instead of Adding a Duplicate

Set **Match by** when the same record can arrive more than once, for example a form that a person submits again, or a webhook that sends an update for one order. The step looks for a task in the project with the same value. If it finds one, it updates that task. If it finds none, it adds a new task.

1. Open the **Add Task** step.
2. Under **Match by**, pick **Task content** to match the task text, or pick a text or number custom field.
3. If you picked a custom field, set a value for that field under **Fields**. The step matches on that value.
4. Save the automation and run a test with a value that is already in the project.

You are done when the test run changes the existing task and the project shows no new copy of it.

How the match works:

- A value matches when it is exactly the same, after spaces at the start and the end are removed.
- The step searches the whole project, not only the block that you picked.
- When a task matches, the step writes the content (if **Content** is set), the custom fields, the due date, and the assignee. **Block** and **Position** apply only to a new task, so the task stays where it is.
- If more than one task has the same value, the run fails. Remove the duplicates so that one task matches, or clear **Match by**.
- **Match by** works on one task at a time. **Content** must not be a list of tasks.
- The step output includes `created`. It is `true` when the step added a task and `false` when it updated the task that matched.

---

## Add Multiple Tasks

The Add Task action supports adding multiple tasks in a single action. To do this, the text must be formatted correctly. Use an [Ask an agent action](https://www.taskade.com/learn/automation/agent-action) to help with the formatting. Try a prompt like this:

```
Your response should help break down the task into a format such as:## Title of Task- Subtask 1- Subtask 2Add a new line character for each new lineCheckboxes can be used with the following format:- [ ] Task A- [ ] Task B
```

One Add Task step turns that format into a task tree like this:

```
┌────────────────────────────────────┐
│ ▸ Title of Task                    │
│    • Subtask 1                     │
│    • Subtask 2                     │
│    ☐ Task A                        │
│    ☐ Task B                        │
└────────────────────────────────────┘
```

This creates multiple tasks in a single action:

![](https://www.taskade.com/static_images/learn/automation/add-task-af909602.png)

---

## Add Custom Fields

Custom fields let you categorize, prioritize, and track new tasks inside projects in a way that fits your team and project goals.

First, make sure that custom fields are enabled inside the target project:

- [Add Custom Fields (Table View)](https://www.taskade.com/learn/projects/custom-fields):
- **Click** the **➕ button** next to the last column (scroll right to see it).
- (method#1) Choose one of the available presets.
- (method #2) Choose **Single select** to add a custom column.

![](https://www.taskade.com/static_images/learn/automation/add-task-434cbc1c.gif)

- Add Custom Fields (All Views):
- Open a project and click ➕ next to a task.
- Choose one of the custom field options at the bottom.

![](https://www.taskade.com/static_images/learn/automation/add-task-e260b98d.jpg)

> **💡 Note**: Want to learn more? Visit our [guide to Custom Fields](https://www.taskade.com/learn/projects/custom-fields).

Once you have defined custom fields, you can add them directly from automation settings:

- Click ➕ **Add step** ➡ **Add Task**.
- Under Fields, click **Add fields**.
- Set values for each field.
![](https://www.taskade.com/static_images/learn/automation/add-task-eae50d3e.jpg)

### Related guides

- [Custom Fields Action](https://www.taskade.com/learn/automation/custom-fields). Update task fields after creation
- [Move Task](https://www.taskade.com/learn/automation/move-task). Reorganize tasks across projects
- [Assign Task](https://www.taskade.com/learn/automation/assign-task). Set owners automatically
- [New Due Date Trigger](https://www.taskade.com/learn/automation/due-date). Schedule tasks from data
- [Custom Fields in Projects](https://www.taskade.com/learn/projects/custom-fields). Set up the fields this action writes to

---
