How to Use the Mail (IMAP) Connector

Document created by magali.kain.boomi Employee on Jan 3, 2018Last modified by Adam Arrowsmith on Feb 7, 2018
Version 10Show Document
  • View in full screen mode

This article discusses how to use the Mail (IMAP) connector to send and receive emails using the IMAP protocol. Let’s see what it takes to get up and running with the Mail (IMAP) connector.


As of the February 2018 release, the Mail (IMAP) connector is a Tech Preview not intended for production use. The Receive and Move operations will be added soon and the connector will be released as Generally Available in a near term release. Follow this document to be notified of future changes.


 Get the example process used below from the Process Library here.




The Mail (IMAP) connector allows you to get and send emails via the IMAP protocol instead of POP. The IMAP protocol--and therefore the IMAP connector--supports additional interaction types when working with emails and may be preferred to POP especially when multiple devices or clients are involved. Many SMTP email servers support both protocols so you may be able to start using the IMAP connector without changes to your server.


For complete connector documentation, see the Mail (IMAP) connector.



The Internet Message Access Protocol (IMAP) can be used in place of the Post Office Protocol (POP). IMAP differs from other mail systems because messages are manipulated directly on the email server. As a result, you can access email from any device at any time, and folders and message status are synchronized.


Notable Improvements vs. the Mail Connector (POP)

  • Take advantage of IMAP-specific functionality (e.g. the ability to retrieve emails from specific folders in a mailbox).
  • Receive attachments AND the email body. This is not possible with the current Mail connector which requires you to choose one or the other when retrieving emails.
  • Ability to send multiple attachments, leveraging the Document Cache component.

  • Specify CC and BCC email addresses when sending.
  • Supports transport security up to TLSv1.2 for sending email.

  • More document properties to dynamically set your operations.

  • Move emails from one folder to another as with an explicit connector call after they have been processed.
  • Additional query/filter options when receiving messages.
  • Test Connection option within connection component to quickly verify connection settings are correct without executing entire process.


Configuring the Mail (IMAP) Connection

When configuring the Mail (IMAP) connection, you configure one single connection. The single connection helps to avoid any potential issues with outgoing and incoming email on the server, and also simplifies setup because you only have to choose the valid connection for each operation.


The following image shows a sample Mail (IMAP) connection.





  • For the outbound mail server, enter the host name, port number, select the security protocol, and if required, enter the user name and password.
  • For the inbound mail server, enter the host name, port number, user name, password, and select the security protocol.


Sending an Email with Attachments

Use the Send operation to send messages to an SMTP mail server. This operation supports attachments through the use of the Document Cache. In this case, all of the related operation fields must be filled.


The following image shows the steps in the Send Message with Attachments Process.



  1. Define a unique value to identify the files that will be sent as attachments for a specific email, and ultimately relates them. To illustrate this, create and set a dynamic process property using a Set Properties Shape.
  2. Add the documents into the Document Cache with only one index and key. In this example, we use a dynamic document property as the key. However, you can use any property.
    As you can see in this example, you must set the key property with the value of the dynamic process property that we created in the previous step.
  3. Set the body, if message has one, using a Message Shape.
  4. Set the “Attachment Cache Key” property belonging to the connector with the same value that is used as the key to store the attachments into the cache. In this example, we assign the value specified on the “ROOT_ID” dynamic process property.
  5. Create a new Send Mail (IMAP) operation and configure the associated Document Cache.


And Here's Your Email!




Receiving an Email COMING SOON...

This article will be updated when the receive functionality is available in a near term release.