> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Todoist OAuth 2.0 connector profile – StackOne setup guide

> Set up the OAuth 2.0 connector profile for Todoist in StackOne. One-time admin setup required before your users can link Todoist accounts via Hub.

<section data-guide-section data-guide-scopes="">
  <h2>Creating a Todoist OAuth App</h2>

  <p>To connect Todoist with StackOne, you need to create an OAuth application in the Todoist App Management Console.</p>

  <Steps>
    <Step title="Access the App Management Console">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your <a href="https://app.todoist.com/auth/login" target="_blank" rel="noopener noreferrer">Todoist account</a> and navigate to the <a href="https://app.todoist.com/app/settings/integrations/app-management" target="_blank" rel="noopener noreferrer">App Management Console</a>, or navigate to <strong>Profile</strong> (top-left corner) > <strong>Settings</strong> > <strong>Integrations</strong> > <strong>Developer</strong> > <strong>App Management</strong>.</p>
      </div>
    </Step>

    <Step title="Create a New App">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click the <strong>Add new integration</strong> button to open the app creation dialog.</p>

        <ul>
          <li>In the <strong>App name</strong> field, enter a name for your application (e.g., StackOne Integration)</li>
          <li>Click <strong>Create app</strong> to create the application</li>
        </ul>
      </div>
    </Step>

    <Step title="Configure the OAuth Redirect URL">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After creating the app, you will be taken to the app settings page. Set the OAuth redirect URL to allow StackOne to receive the authorization callback.</p>

        <ul>
          <li>In the <strong>OAuth redirect URL</strong> field, enter `https://api.stackone.com/connect/oauth2/todoist/callback`</li>
          <li>Click <strong>Save settings</strong> to apply the configuration</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy Your Credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Your credentials are displayed on the app settings page.</p>

        <ul>
          <li>Copy the <strong>Client ID</strong> value</li>
          <li>Copy the <strong>Client Secret</strong> value</li>
          <li>Store both values securely for use later</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Configuring OAuth Scopes</h2>

  <p>Choose the appropriate scopes based on the level of access your integration requires.</p>

  <Steps>
    <Step title="Select Required Scopes">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Todoist uses the following OAuth scopes to control access.</p>

        <ul>
          <li>`data:read` - Read-only access to tasks, projects, labels, and filters</li>
          <li>`data:read_write` - Full read and write access to application data (includes `task:add` and `data:read`)</li>
          <li>`task:add` - Permission to add new tasks only (cannot read or modify existing data)</li>
          <li>`data:delete` - Permission to delete tasks, labels, and filters</li>
          <li>`project:delete` - Permission to delete projects</li>
        </ul>
      </div>
    </Step>

    <Step title="Recommended Scopes">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>For most integrations, use `data:read_write,data:delete,project:delete` to enable full functionality.</p>

        <ul>
          <li>Enter scopes as a comma-separated list with no spaces</li>
          <li>Example: `data:read_write,data:delete,project:delete`</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>Todoist</strong>:

<Steps>
  <Step title="Navigate to Connector Profiles">
    Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  </Step>

  <Step title="Create New Connector Profile">
    <ul>
      <li>Click <strong>+ Connector Profile</strong></li>
      <li>Search for and select <strong>Todoist</strong></li>
      <li>Select <strong>Type</strong> as <strong>OAuth 2.0</strong></li>

      <li>
        Fill out the fields using details retrieved from your provider:

        <ul style={{ marginLeft: '20px' }}>
          <li><strong>Client ID</strong></li>
          <li><strong>Client Secret</strong></li>
          <li><strong>Application Scopes</strong> (Optional)</li>
        </ul>
      </li>

      <li>(Optional) Select <strong>Actions</strong> to be enabled for this Connector Profile</li>
      <li>Click <strong>Create profile</strong></li>
    </ul>
  </Step>
</Steps>

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to <a href="/guides/accounts-section#linking-accounts">Link Accounts</a> for <strong>Todoist</strong>.