--- title: Configuring an Email Account for Import description: Setting up email import requires adding a mail account in Essal Office's settings. Essal Office uses IMAP to connect to the mailbox and retrieve messa... --- [Skip to content](https://help.essal.cloud/en/article/1472-#main-content) English Show submenu for translations [More support](https://help.essal.cloud/en/kb-tickets/new?hsLang=en) [Customer portal](https://clients.essal.cloud/tickets?hsLang=en) [![logo](https://help.essal.cloud/hubfs/logo.svg)](https://help.essal.cloud/?hsLang=en) - [Home](https://essal.cloud/) - [Products](https://essal.cloud/products) - [Industries](https://essal.cloud/industries) - [About](https://essal.cloud/about) - [Contact](https://essal.cloud/contact) Open main navigation Close main navigation - [Home](https://essal.cloud/) - [Products](https://essal.cloud/products) - [Industries](https://essal.cloud/industries) - [About](https://essal.cloud/about) - [Contact](https://essal.cloud/contact) - English Show submenu for translations - [More support](https://help.essal.cloud/en/kb-tickets/new) - [Customer portal](https://clients.essal.cloud/tickets) - [Home](https://essal.cloud/) [Home](https://essal.cloud/) Essal Help Center - There are no suggestions because the search field is empty. 1. [Help Center](https://help.essal.cloud/en?hsLang=en) 2. [Essal Office](https://help.essal.cloud/en/essal-office?hsLang=en) 3. [Email import](https://help.essal.cloud/en/essal-office?hsLang=en#email-import) # Configuring an Email Account for Import Setting up email import requires adding a mail account in Essal Office's settings. Essal Office uses IMAP to connect to the mailbox and retrieve messages. You will need access credentials for the dedicated import mailbox. --- ## Before You Start - Create or designate a dedicated email address for imports (e.g. `archive@yourcompany.com` or `documents@yourcompany.com`) - Obtain the IMAP server hostname, port, and login credentials for that address - Ensure that IMAP access is enabled for the mailbox in your email provider's settings - Confirm the mailbox is empty or contains only emails you want imported on first run --- ## Adding a Mail Account 1. Go to **Settings** (or **Administration \> Mail Accounts**) 2. Click **Add mail account** 3. Fill in the connection details: - **Field**: \*\*Account name\*\* - **Description**: A label for this account within Essal Office (e.g. \`Invoice Import\`) - **Field**: \*\*IMAP server\*\* - **Description**: The hostname of your IMAP server (e.g. \`imap.yourprovider.com\`) - **Field**: \*\*IMAP port\*\* - **Description**: Typically 993 for SSL/TLS or 143 for STARTTLS - **Field**: \*\*Username\*\* - **Description**: The login username for the mailbox (usually the full email address) - **Field**: \*\*Password\*\* - **Description**: The account password or app-specific password - **Field**: \*\*Security\*\* - **Description**: Select SSL/TLS or STARTTLS matching your server's requirements 1. Click **Test connection** to verify Essal Office can reach the mailbox 2. Click **Save** if the test succeeds --- ## IMAP Security and App Passwords Most modern email providers (Google Workspace, Microsoft 365, etc.) require you to generate an **app-specific password** rather than using your main account password. This is more secure and avoids account lockouts if 2FA is enabled. Generate the app password from your email provider's account security settings and use it in the Password field above. --- ## Configuring Mail Rules After adding the mail account, you define **mail rules** — conditions that tell Essal Office what to do with each incoming message. See Setting Up Mail Rules. --- ## Testing the Import After setup, trigger a manual import check. Go to the mail account in settings and click **Run import now** (or equivalent). Check whether expected messages have been processed. Any errors in connecting or processing are logged and visible in the task queue. - [Essal Office](https://help.essal.cloud/en/essal-office?hsLang=en#main-content) - [Getting started](https://help.essal.cloud/en/essal-office?hsLang=en#getting-started) - [Searching and saved views](https://help.essal.cloud/en/essal-office?hsLang=en#searching-and-saved-views) - [Correspondents and document types](https://help.essal.cloud/en/essal-office?hsLang=en#correspondents-and-document-types) - [Email import](https://help.essal.cloud/en/essal-office?hsLang=en#email-import) - [Users groups and permissions](https://help.essal.cloud/en/essal-office?hsLang=en#users-groups-and-permissions) - [Sharing documents](https://help.essal.cloud/en/essal-office?hsLang=en#sharing-documents) - [Working with documents](https://help.essal.cloud/en/essal-office?hsLang=en#working-with-documents) - [Pdf tools](https://help.essal.cloud/en/essal-office?hsLang=en#pdf-tools) - [Uploading documents](https://help.essal.cloud/en/essal-office?hsLang=en#uploading-documents) - [Archive serial numbers](https://help.essal.cloud/en/essal-office?hsLang=en#archive-serial-numbers) - [Workflows and automation](https://help.essal.cloud/en/essal-office?hsLang=en#workflows-and-automation) - [Organizing with tags](https://help.essal.cloud/en/essal-office?hsLang=en#organizing-with-tags) - [Troubleshooting and faq](https://help.essal.cloud/en/essal-office?hsLang=en#troubleshooting-and-faq) - [Account and security](https://help.essal.cloud/en/essal-office?hsLang=en#account-and-security) - [Custom fields](https://help.essal.cloud/en/essal-office?hsLang=en#custom-fields) - [Portal](https://admin.essal.cloud/) - [Newsroom](https://newsroom.essal.cloud/) - [Careers](https://careers.essal.cloud/) - [Help](https://support.essal.cloud/) - [Status](https://status.essal.cloud/) - [Contact](https://essal.cloud/contact) - [Terms](https://legal.essal.cloud/terms) [![logo](https://help.essal.cloud/hubfs/logo.svg "logo")](https://essal.cloud/) Essal LLC Copyright © 2026, Essal