OAuth providers
Todoist
Set up Todoist OAuth for task and project management
Overview
Section titled “Overview”Connect your users to Todoist for task management, project organization, and productivity tracking.
| Property | Value |
|---|---|
| Provider ID | todoist |
| Category | Productivity |
| PKCE | Not supported |
| Token refresh | Automatic (new apps); legacy apps use permanent tokens |
| Redirect URI | Shown in Developer Portal |
Step 1: Create a Todoist OAuth App
Section titled “Step 1: Create a Todoist OAuth App”Go to the Todoist App Console
Navigate to Todoist Settings → Integrations → App Management and sign in.
Create a new app
Click Create a new app, enter the app name and description, and submit.
Configure the redirect URI
Add the Alter callback URL from the Developer Portal to the OAuth redirect URL field.
Get credentials
Copy the Client ID and Client Secret.
Step 2: Add to Alter Vault
Section titled “Step 2: Add to Alter Vault”Open the Developer Portal
Go to portal.alterauth.com and navigate to the application.
Add Todoist provider
Go to OAuth Providers > Add Provider > Todoist.
Enter credentials
- Client ID: Paste your Todoist Client ID
- Client Secret: Paste your Todoist Client Secret
Select scopes
Choose the scopes the application needs.
Save
Click Save. The provider is now active.
Available Scopes
Section titled “Available Scopes”| Scope | Description |
|---|---|
task:add | Add tasks to the user’s inbox |
data:read | Read all user data |
data:read_write | Read and write all user data |
data:delete | Delete user data |
project:delete | Delete projects |
- Newly-created Todoist apps issue refresh tokens by default; access tokens expire after one hour and Alter Vault renews them automatically. Apps created before refresh tokens were introduced continue to receive long-lived tokens that do not expire.
- For most integrations,
data:readordata:read_writeis sufficient. - See the Todoist authorization documentation for more details.