+
Taskip + IMAP / Webmail
IMAP / Webmail
This document provides a comprehensive guide on how to connect external email accounts via IMAP to the system.
About this Integration
This document provides a comprehensive guide on how to connect external email accounts via IMAP to the system.
📋 Connection Requirements
To connect an email account via IMAP, you will need the following information from your email provider:
| Parameter | Description | Example |
|---|---|---|
| IMAP Host | The server address of your email provider. | imap.gmail.com |
| IMAP Port | The port used for the connection. | 993 (SSL/TLS) or 143 (STARTTLS) |
| Encryption | The security protocol for the connection. | ssl, tls, or starttls |
| Email Address | Your full email address. | user@example.com |
| Password | Your account password or an App Password. | •••••••••••• |
🔐 Security & App Passwords
If your email provider uses Two-Factor Authentication (2FA) or has high security standards, a regular password may not work. You must generate an App Password.
📧 Gmail
- Go to your Google Account Settings.
- Navigate to Security.
- Under “How you sign in to Google,” ensure 2-Step Verification is ON.
- Select App passwords.
- Select “Mail” and “Other (Custom name)” to generate a 16-character password.
- Use this 16-character password instead of your regular password.
✉️ Outlook / Microsoft 365
- Go to Microsoft Security Basics.
- Select Advanced security options.
- Under App passwords, select “Create a new app password”.
- Copy the generated password and use it in the system.
⚙️ Common Provider Settings
| Provider | IMAP Host | Port | Encryption | SMTP Host (Optional) | SMTP Port |
|---|---|---|---|---|---|
| Gmail | imap.gmail.com | 993 | ssl | smtp.gmail.com | 587 |
| Outlook / Office 365 | outlook.office365.com | 993 | ssl | smtp.office365.com | 587 |
| Yahoo Mail | imap.mail.yahoo.com | 993 | ssl | smtp.mail.yahoo.com | 465 |
| iCloud | imap.mail.me.com | 993 | ssl | smtp.mail.me.com | 587 |
🚀 Connection Steps
- Navigate to
Dashboard > Settings > Integrations. - Select the IMAP/Email Connection option.
- Fill in the IMAP Host, Port, and Encryption details.
- Enter your full Email address and Password (or App Password).
- (Optional) Provide SMTP Host and Port if you want to send emails from this account.
- Test Connection to ensure the credentials are correct.
- Save the connection. The system will start an initial sync of your emails.
❓ Troubleshooting
- Authentication Failed: Double-check your email and password. Ensure you are using an App Password if 2FA is enabled.
- Connection Timeout: Ensure the IMAP Host and Port are correct. Check if your server allows external IMAP connections.
- Gmail Access: Ensure “IMAP Access” is enabled in your Gmail settings under
Settings > Forwarding and POP/IMAP > IMAP Access.
[!NOTE] Initial sync may take a few minutes depending on the size of your inbox. You can check the sync status in the connection list.