# Adding a Feed to Create Todoist Tasks

<figure><img src="/files/At5235pZsbFG3EVlc9Ck" alt=""><figcaption><p>Forms Screen in Gravity Forms</p></figcaption></figure>

You can navigate to create a new feed by navigating to **Forms > Your Form > Settings > Todoist**. First, go to **Forms**. You'll find a list of your current forms. From there, go to the form's settings, or simply hover over Settings. Then find **Todoist**.

You'll be presented with the Todoist feeds screen.

<figure><img src="/files/H4KCNFqT4e976r1pMxLj" alt=""><figcaption><p>Empty Feeds Screen Under Todoist Feed Settings</p></figcaption></figure>

Click on "Add New" to create a new feed.

### Configuring a Feed

<figure><img src="/files/cZNNZ21nKnGiPt5GwAjV" alt=""><figcaption><p>New Feed Screen in the Todoist Feed Settings</p></figcaption></figure>

Once on the feed screen, you can add in a feed name (recommended) and start selecting which project and section a task should be filed under.

#### Setting a Project

<figure><img src="/files/dgMC0uqoLy1vCVaL7uJt" alt=""><figcaption><p>Select a Project to File a Task Under</p></figcaption></figure>

You can select from any existing project you have created. If you need to create a new project for your feed, you can also do so via an Add Project modal. You can also make the project in Todoist and perform a Refresh to refresh the projects.

If you select "Custom," you can use merge tags to create projects dynamically.

<figure><img src="/files/GeDqetlzlrXa4yFgQLVf" alt=""><figcaption><p>Custom Project With Merge Tags</p></figcaption></figure>

Note that if you are using merge tags, any matching projects by name will have the task filed under it. While technically you can have duplicate project names in Todoist, the HeyTodos plugin will check for an existing project before creating a new one.

{% hint style="warning" %}
Select 'Custom' for Project requires 'Custom' for Sections if you want to assign a task to a section.
{% endhint %}

#### Setting a Section

<figure><img src="/files/QckInU03pDfR7UmasIjt" alt=""><figcaption><p>Setting a Section</p></figcaption></figure>

If a project has any sections, they will be displayed in this section. If there are no sections for a project, you can either create a new one using the built-in modal or choose 'Custom' to use merge tags for a dynamic section.

{% hint style="danger" %}
There's **a max of 20 sections for each project** per Todoist limits.
{% endhint %}

#### Setting Labels

<figure><img src="/files/PDRnSQr2cT5hQVlFj7mm" alt=""><figcaption><p>Set Todoist Labels for the Task</p></figcaption></figure>

You can use any available Todoist labels to mark the task. Please note that Todoist doesn't differentiate between project and workspace labels, so all labels across the workspace are available. You can add any label that exists.

You can create new labels from an "Add Custom Label" modal.

<figure><img src="/files/j77AJZzGxjUxXHC2OtYZ" alt=""><figcaption><p>Add Label Modal</p></figcaption></figure>

To add custom labels, click the Toggle that says, "Enable Custom Labels."

<figure><img src="/files/ru7rkUmHCi43pcbbHhFO" alt=""><figcaption><p>Enable Custom Labels With Merge Tag Support</p></figcaption></figure>

From there, you can use merge tags to create labels dynamically. Labels are assumed to be comma-separated in this section.

#### Assign Collaborators

<figure><img src="/files/IVR0CsjUDqjSC2fizAiK" alt=""><figcaption><p>Assign Project Collaborators if a Project Supports It</p></figcaption></figure>

If you are on a personal/pro/business plan, then each project can have a collaborator. If a collaborator for a project is found, you can assign a collaborator from this section.

{% hint style="danger" %}
On a Teams plan, it is not possible to assign Workspace Users via the API.
{% endhint %}

#### Set the Task Title and Description

<figure><img src="/files/Cb8qLOg5wF2tpLPgKmHm" alt=""><figcaption><p>Use Merge Tags to Complete the Task Title and Description</p></figcaption></figure>

You can manually add a task title and description, or use merge tags to make them dynamic.

#### Adding a Priority

<figure><img src="/files/0p397viPmg1MMv5Kmo55" alt=""><figcaption><p>Set a Task Priority</p></figcaption></figure>

You can set a task priority from low to urgent. This value is not dynamic.

#### Add a Due Date

<figure><img src="/files/upJt10pd7Pps63y7TaGX" alt=""><figcaption><p>Add a Natural Language Due Date</p></figcaption></figure>

Todoist supports natural "human" dates, so you can use a phrase like "One week from Friday" to have a rolling due date.

You can also set it for a fixed period after the task creation date.

<figure><img src="/files/8AZoMoKAMhkGkxzXaNJ0" alt=""><figcaption><p>Due Date Calculated From Start Date</p></figcaption></figure>

#### Set a Task Duration

<figure><img src="/files/YR10OUncFGOjow8sJhrY" alt=""><figcaption><p>Set Task Duration</p></figcaption></figure>

Set up a task duration (in minutes or days) to set how long a task should take.

#### Set up Conditional Logic to Determine When a Task is Created

<figure><img src="/files/GPqznZvP5rBOyJRvJ1SY" alt=""><figcaption><p>Conditional Logic Options</p></figcaption></figure>

Lastly, you can use conditional logic to determine when a task should be created.

### Conclusion

When done configuring a feed, it is a best practice to do a test submission of your form to verify the task is being created correctly.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dlxplugins.com/heytodos/getting-started/adding-a-feed-to-create-todoist-tasks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
