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, Mailhook, Form, or 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 turns an incoming event into structured work.

Add Task Actions
Here are the triggers & 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.
- Open the Add Task step.
- Under Match by, pick Task content to match the task text, or pick a text or number custom field.
- If you picked a custom field, set a value for that field under Fields. The step matches on that value.
- 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 istruewhen the step added a task andfalsewhen 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 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:

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):
- 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.

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

Note: Want to learn more? Visit our guide to 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.

Related guides
- Custom Fields Action. Update task fields after creation
- Move Task. Reorganize tasks across projects
- Assign Task. Set owners automatically
- New Due Date Trigger. Schedule tasks from data
- Custom Fields in Projects. Set up the fields this action writes to