# Connecting to Todoist

## Connecting to Todoist

Once HeyTodos is installed and activated, you’ll need to connect it to your Todoist account. This connection allows HeyTodos to create tasks directly from Gravity Forms submissions.

***

### Step 1: Open HeyTodos Settings

<figure><img src="/files/BYPjlOq8VPOYDMT7wKBf" alt=""><figcaption><p>Todoist Settings Screen</p></figcaption></figure>

1. In your WordPress dashboard, navigate to **Forms → Settings → Todoist**.
2. You’ll see the option to connect your Todoist account.

### Step 2: Enter your License

<figure><img src="/files/SasEmEHfYPEozGuzyQuK" alt=""><figcaption><p>License Prompt in the HeyTodos App</p></figcaption></figure>

A license is required to connect to Todoist. You can retrieve your license from either your [account section](https://dlxplugins.com/account/) or the welcome purchase email.

***

### Step 3: Authorize with Todoist

<figure><img src="/files/COr3SGzEejF4G51tdLHv" alt=""><figcaption><p>Authorize Dialogue for Todoist</p></figcaption></figure>

1. Click **Connect to Todoist**.
2. You’ll be redirected to the HeyTodos Todoist app to authorize Todoist.
3. Log in with your Todoist credentials if you aren’t already signed in.
4. Review the permissions that HeyTodos is requesting, then click 'Agree'.

***

### Step 4: Authorize and Sync Todoist Data

<figure><img src="/files/29GwfC7Ukllv1DM1f5bn" alt=""><figcaption></figcaption></figure>

After authorizing, you’ll be redirected back to WordPress. If successful, you’ll see:

* A setup wizard initiates the authorization and synchronization process.
* Follow the prompts to set up Todoist and sync your Todoist data.

{% hint style="warning" %}
**Syncing is required**: To speed up the lookup process for Projects, Sections, and Labels, particularly during feed processing, it is necessary to have local Todoist data.
{% endhint %}

### Step 5: Select a Workspace (if on Teams)

<figure><img src="/files/iXMGBLgwDVD8EjoG4m1P" alt=""><figcaption><p>Select a Workspace Screen</p></figcaption></figure>

If you have a Teams account, you can select your Teams workspace on this screen. If you don't have a Teams account, you can proceed to Syncing.

### Step 6: Sync Todoist Data and Cleanup

Proceed to data syncing to sync all your Todoist data. Make sure to run cleanup and you'll be redirected back to the Gravity Forms Todoist dashboard.

<figure><img src="/files/Pog0kEjHkRTSsHmGSlU6" alt=""><figcaption><p>Todoist Data Syncing Screen</p></figcaption></figure>

### Last Step: View the Todoist Dashboard

<figure><img src="/files/uEAXTFej3y7xiBVRreVg" alt=""><figcaption><p>HeyTodos Dashboard</p></figcaption></figure>

With the connection complete, you’re able to:

* Set project and section defaults.
* Resync Todoist data.
* Disconnect and revoke the Todoist token.


---

# 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/connecting-to-todoist.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.