Inbound email connector

When to use this connector

To read data from a mail server, you need to create an Inbound Email Connection.

Read how to extract data from a mail server.

Create a Connection

Start creating an Inbound Email Connection by opening the Connections window, clicking +, and typing mail into the filter field in the Select Connection Type  gallery, then selecting Inbound Email.

Connection parameters

If you are using one of the public email providers, for example, Gmail, make sure to enable POP3 and IMAP for your account and make sure that your account can be accessed from less secure applications (Google's official name for third-party applications, as opposed to registered email clients).

• Protocol: the inbound email protocol.
• Host: the inbound email server host.
• Port: the inbound email server port.
• User: the user name.
• Password: the password.
• Delete After Reading: if enabled, previously read messages will be automatically deleted from the Inbox.
• Read Only New: if enabled, only new (unread) messages will be retrieved.
• From: use this if you need to filter emails based on the FROM field. Partial matching is used. For example, an etlworks.com filter will include all emails sent from the domain etlworks.com and exclude everything else.
• Subject: use this if you need to filter emails based on the Subject field. Partial matching is used. For example: important! will include all emails which include the subject important! and exclude everything else.
• Folder: the name of the folder to read messages from. The default is Inbox.
• File: the name of the file attached to the message. Wildcard file names are allowed. If this field is specified, the Etlworks Integrator will expect an attachment that matches the given name.
• Dump Attachments To: the name of the folder on the server to dump attachments into. It is possible to use the token {app.data} to dump files to the account's home folder. 

If this field is specified, the Etlworks Integrator will dump the attachment to the given folder and return an empty result.

• Received After: the date, in a MM/DD/YYYY Format. If a date is entered, the Etlworks Integrator will read only the messages received after the specified date and ignore everything else.
• Received Before: the date in a MM/DD/YYYY Format. If a date is entered, the Etlworks Integrator will read only the messages received before the specified date and ignore everything else.
• Properties: additional comma-separated Connection properties in a key-value Format. Read more about JavaMail Connection properties.