Troubleshoot the Todoist and Outlook Mail integration


Are you having trouble turning your Outlook emails into Todoist tasks? This troubleshooting guide provides steps to fix common issues with the integration, so you can get straight back to work.

Limitations

If you're using the Outlook desktop app, and the Todoist add-in isn't visible in your settings, your account may not have Connected Experiences turned on yet. Follow these steps to turn this option on for your Outlook Mail account.

If you’re trying to set up the Outlook add-in, but the Manage Add-ins option isn’t visible, you’re either using a corporate account where your administration disabled the installation of web add-ins, or you are using an account type that isn’t supported by web add-ins, like an IMAP or POP3 account.

The Outlook add-in only works with email accounts hosted on Microsoft’s cloud services, such as Office 365 email accounts and cloud-enabled Microsoft Exchange accounts. If your mailbox is on a Microsoft Exchange server run by a third-party provider (not Exchange Online), the integration won’t work, even if you sign in through your organization’s Microsoft 365 or Microsoft Entra ID account. Approving the add-in in your organization’s Microsoft 365 settings doesn’t change this.

Here’s the full list of supported email services. As an alternative, you can forward emails to Todoist to turn them into tasks.

Due to security restrictions that Google places upon apps, it's not possible to use Google login to authenticate your Todoist account. As a workaround, add a password to your Todoist account, and use login via email and password to authenticate. 

When clicking an Outlook email in a Todoist task, your default web browser opens a new tab automatically where you can view the email. It's not possible to view the email right in Outlook.

Errors

If you’re signing in to the Outlook add-in with your Google account, you may see this error message:

This browser or app may not be secure.

To resolve this, open Outlook web app and log in with your Google account.

If you’re using the Outlook desktop app or mobile app, log in with your Todoist email address and password instead. If you don’t have a password, here’s how to add one.

When using the Outlook Add-in, you may see this error message:

Outlook plugin is unverified and needs admin approval.

To resolve this, contact your network admin to grant access to the Integrated Apps option in the O365 admin portal. Then, have them select Add Apps and search for Todoist for Outlook.

From there, your network admin can choose to deploy the integration either for all users or for specific users. They’ll need to agree to the required permissions:

  • Read basic email
  • Sign you in and read your profile
  • Maintain access to data you have given it access to

Todoist only uses Read basic email to link tasks back to their email. This permission doesn’t give Todoist access to message bodies or attachments.

Todoist for Outlook asks Microsoft for the Read basic email permission instead of Read your mail. If your organization only lets admins approve app permissions, you may see a Need admin approval message the first time you connect Outlook.

Todoist only uses this permission to link a task back to its email. It can’t read the email body or attachments.

To resolve this, your Microsoft 365 admin needs to approve the new permission once:

  1. Open the Microsoft Entra admin center.
  2. Go to Enterprise applications.
  3. Open Todoist for Outlook Mail.
  4. Select Permissions.
  5. Click Grant admin consent.

Microsoft labels the permission Read basic email in all mailboxes, but it only covers the signed-in user’s own mailbox.

When adding an email as a task, you may see this error message:

Something went wrong and we couldn’t start this add-in. Please try again later or contact your system administrator.

This means Microsoft refused the add-in’s request for the Read basic email permission. Either the Microsoft permission prompt was closed or declined, or your organization doesn’t let users approve apps on their own.

To resolve this, log out of the add-in and log back in:

  1. Open an email in Outlook and open the Todoist add-in.
  2. Click the gear icon at the top-right of the add-in and log out.
  3. Log back in with your Todoist account.
  4. When Microsoft asks for permission, approve it.
  5. Try adding the email as a task again.

If no permission prompt appears, or the error comes back, ask your Microsoft 365 admin to do one of the following:

  • In Microsoft Entra ID, open Enterprise applications > User consent settings and select Allow user consent for apps from verified publishers, for selected permissions.
  • Approve Todoist for Outlook for all users from Integrated Apps. Here’s how to do this.

If you're using Todoist on a company network, and you see an error that starts with:

Something went wrong

AADSTS: error description

Contact your IT department or administration and provide the exact AADSTS error code (for example: AADSTS50158) to help with troubleshooting. Here's a full list of Microsoft AADSTS error codes.

If you’re consistently seeing a message about a missing weblink, there are two likely reasons:

1. Your IT team may be blocking email links from being accessed by our integration through Microsoft. If that’s the case, we recommend reaching out to them to request an exception for Todoist.

2. Microsoft may not be providing the link at all. We’re not sure why this happens. We’ve reached out to them but haven’t received a response. If this is the case for you, unfortunately, there’s nothing we can do on our end to fix it.

Missing or archived email messages

The Outlook add-in needs your permission to access the Microsoft Graph API to fetch a robust link to the email. This link is attached to your Todoist task. This is the only time Todoist requests your permission to access the API, nothing else. 

If you’re using the Outlook add-in, and it keeps prompting you to log in to your Microsoft account when you click the link, the email has likely been moved to another folder.

To open an email that’s been moved to another folder, like your Archive folder, log in to your Microsoft account when prompted and grant permission to use the Microsoft Graph API. After that, the email link works again.

If you choose to log out of your account in the add-in settings, you’ll also log out of both your Todoist account and your Microsoft account.

Email links keep working when you move the linked email to another folder in Outlook. If a link doesn’t open, log in to your Microsoft account when the add-in prompts you, then try the link again. Here’s more about these prompts.

If the link still doesn’t work, use the add-in to create a new task from the email. We recommend deleting the old task with the broken link in Todoist.

When adding an email as a task, you may see a message that the task will be created without a link back to Outlook. This happens when the Email Links in Tasks toggle is off. The add-in turns it off when the Microsoft sign-in is skipped or doesn’t go through.

To turn email links back on:

  1. Open an email in Outlook and open the Todoist add-in.
  2. Click the gear icon at the top-right of the add-in to open its settings.
  3. Turn on the Email Links in Tasks toggle.
  4. When you’re asked to sign in, use the same Microsoft account you use for Outlook.
  5. Add an email as a task and check that it has the link.

Tasks created while the toggle was off won’t get a link added later. Add those emails again from the add-in, then delete the old tasks.

If the Microsoft sign-in fails or says access was denied, your organization may be blocking the add-in from signing in to your Microsoft account. Ask your IT team to allow Todoist for Outlook to use Microsoft sign-in.

Get in touch

If you’ve tried all the troubleshooting steps in this article, or if you’re seeing a new issue when using the integration, get in touch with us and include the following details in your report:

  • Outlook and Todoist app version numbers
  • Screenshots of any errors or warning messages
  • Any other troubleshooting steps you’ve tried to resolve the issue