In this article
Overview
You can use the account type to connect Email Snaps with data sources that use IMAP, POP3, and SMTP accounts. The different account types and the supported Email Snaps are listed below:
IMAP - Email Reader, Email Delete, and Email Archive Snaps.
POP3 - Email Reader and Email Delete.
SMTP - Email Sender.
Ask your email administrator which option is best for you to use. Account settings are common for all the three accounts.
Limitations
If using Gmail, you may need to turn on the option to allow less secure apps to access your account within Gmail. See Less secure apps & your Google Account - Google Account Help for more information.
Due to the anti-email-hijacking policies of webmail servers, the Email Snaps often fail to perform as expected.
It is a trend for webmail servers (e.g. gmail, yahoo, hotmail, etc.) to enforce their security policy increasingly against all email client applications which access email accounts through email API (SMTP, IMAP, etc), other than web browsers, if the client applications access from a geographical location far from usual locations of the web browser logins. The Email Snaps are often classified as suspicious email hijacker since the Snaps try to access the email server from AWS, a location different from usual web browser logins of users. Sometimes, users can find additional information in the emails from the mail servers or in the security page of the account. The Email Snaps function well as expected if their accounts are not from webmail servers.
Known Issues
None.
Account Settings
Asterisk (*): Indicates a mandatory field.
Suggestion icon (
): Indicates a list that is dynamically populated based on the configuration.Expression icon (
): Indicates whether the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.Add icon (
): Indicates that you can add fields in the fieldset.Remove icon (
): Indicates that you can remove fields from the fieldset.
The fields available for all the account configurations are the same.
SMTP accounts cannot be validated before sending any email due to the nature of the SMTP Servers. Therefore, no Validate button is provided in SMTP accounts.
Field Name | Field Type | Description | |
|---|---|---|---|
Label* Default Value: None | String | Specify a unique label for the account. | |
Email ID Default Value: None | String | Specify the email ID to use for this account. | |
Password Default Value: None | String | Specify the the password for the account. | |
Server domain* Default Value: None | String | Specify the name of the server domain. | |
Port* Default Value: None | Integer | Specify the port number of the email server. This will vary depending on your mail provider and the Secure connection selected. The default port for IMAP is 993. | |
Secure connection* Default Value: None | String | Select how the secure connection to the email server should be initiated. Options available include:
| |
Attachment password Default Value: None | String | Specify the password for attachment URL. | |
Connection timeout Default Value: 60000 | Integer | Specify the time duration in milliseconds, in the event of a connection error, after which the server will not try reconnecting. | |
Read Timeout Default Value: 60000 | Integer | Specify the time duration in milliseconds, in the event of a read error, after which the server will not try to read the data. | |
Write Timeout Default Value: 60000 | Integer | Specify the time duration in milliseconds, in the event of a write error, after which the server will not try to write the data. | |
Mail properties | Specify advanced parameters that you want to include in the request. | ||
Mail property name Default Value: None | String | Specify the name of the mail property. | |
Mail property value Default Value: None | String | Specify the mail property value associated with the mail property name. | |
Snap Pack History
Release Snap Pack Version Date Type Updates November 2024 main29029 Stable Updated and certified against the current SnapLogic Platform release. August 2024 main27765 Stable Upgraded the May 2024 main26341 Stable Updated and certified against the current SnapLogic Platform release. February 2024 main25112 Stable Updated and certified against the current SnapLogic Platform release. November 2023 main23721 Stable Updated and certified against the current SnapLogic Platform release. August 2023 main22460 Stable Updated and certified against the current SnapLogic Platform release. May 2023 main 21015 Stable Upgraded with the latest SnapLogic Platform release. February 2023 432patches20237 Latest The JSCH library has been upgraded to version 0.2.7. February 2023 main19844 Stable Upgraded with the latest SnapLogic Platform release. November 2022 main18944 Stable Upgraded with the latest SnapLogic Platform release. August 2022 430patches17403 Latest The Email Account now does not display a null pointer exception when the Mail Properties fieldset is left blank as this is not a mandatory field. Earlier, the account displayed a null pointer exception for null values in this fieldset. August 2022 main17386 Stable The Email Sender Snap supports the 4.29 main15993 Stable Upgraded with the latest SnapLogic Platform release. 4.28 Patch 428patches14812 24 Mar 2022 Latest Fixed an issue with the Email Sender Snap where SMB files were attached to an e-mail causing the Snaps to fail with a 4.28 main14627 12 Feb 2022 Stable Upgraded with the latest SnapLogic Platform release. 4.27 main12833 13 Nov 2021 Stable Upgraded with the latest SnapLogic Platform release. 4.26 Patch 426patches11591 21 Sep 2021 Latest Fixed the following issues with the Email Archive Snap where the Snap: Failed with an error Caused multiple copies of the same source message in the target folder when the Snap was executed multiple times in preview. 4.26 main11181 14 Aug 2021 Stable Upgraded with the latest SnapLogic Platform release. 4.25 main9554 08 May 2021 Stable Upgraded with the latest SnapLogic Platform release. 4.24 main8556 13 Feb 2021 Stable Upgraded with the latest SnapLogic Platform release. 4.23 main7430 14 Nov 2020 Stable Upgraded with the latest SnapLogic Platform release. 4.22 422patches6730 17 Sep 2020 Latest Fixes the connectivity issue for the Email Sender Snap by making it compatible with TLS version 1.2. 4.22 main6403 12 Sep 2020 Stable Upgraded with the latest SnapLogic Platform release. 4.21 snapsmrc542 - Stable Upgraded with the latest SnapLogic Platform release. 4.20 Patch email8813 - Latest Fixes an issue with the Email Sender Snap that caused the Snap to fail while uploading attachments to SMB locations when the attachment password contained a forward slash "/". 4.20 snapsmrc535 - Stable Upgraded with the latest SnapLogic Platform release. 4.19 snaprsmrc528 - Stable Upgraded with the latest SnapLogic Platform release. 4.18 snapsmrc523 - Stable Upgraded with the latest SnapLogic Platform release. 4.17 Patch ALL7402 - Latest Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers. 4.17 snapsmrc515 - Stable Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box. 4.16 Patch email6772 - Latest Fixed an issue with the Email Delete Snap wherein the Snap fails to delete emails with multiple input documents. 4.16 snapsmrc508 - Stable Upgraded with the latest SnapLogic Platform release. 4.15 Patch email6267 - Latest Fixed an issue with handling null attachments in the Email Sender and Email Reader Snaps. 4.15 snapsmrc500 - Stable Upgraded with the latest SnapLogic Platform release. 4.14 Patch email5740 - Latest Fixed an issue with POP3 access in Email Reader, Archive, and Delete Snaps. IMAP specific methods are now not called during POP3 access. 4.14 Patch email5662 - Latest Fixed the Email Reader/Sender Snaps that replace the "+" symbol in attachment files with a space in the output. 4.14 snapsmrc490 - Stable Upgraded with the latest SnapLogic Platform release. 4.13 Patch email5368 - Latest Enhanced Email Reader Snap to perform read and archive functions. Fixed the Email Archive Snap that does not display sorting errors. Fixed the Email Reader Snap that slows down when renaming the downloaded attachments. 4.13 snapsmrc486 - Stable Upgraded with the latest SnapLogic Platform release. 4.12 Patch email4948 - Latest Fixed an issue with the Email Reader Snap, wherein the Snap gets corrupted when a file name and content contains Unicode characters. 4.12 snapsmrc480 - Stable Upgraded with the latest SnapLogic Platform release. 4.11 Patch email4481 - Latest Resolved an issue with Email Reader Snap: The Snap now reads to fetch mails from a shared mail box. The Snap can now read the file attachment that has a percent sign [%], or ó. Updated the Email Delete Snap code to display the default value as zero instead of blank in the UI. 4.11 snapsmrc465 - Stable Upgraded with the latest SnapLogic Platform release. 4.10 Patch email4025 - Latest Added Connection, Read, and Write timeout settings that support retries for SMTP, POP3, and IMAP email account types. 4.10 Patch email3944 - Latest Resolved an issue with the Email Reader Snap to support the shared mailbox on an Office 365 server. Email Reader did not support Office 365 shared mailbox until we explicitly disabled plaintext authentication when we specify ssl authentication. The Office server falsely reports that it supports PLAIN authentication and the snap library is happy to try it but it always fails. This is a known issue with Office 365 / Outlook. 4.10 snapsmrc414 - Stable Email Account Updated with Attachment password property (encrypted) to support the attachment function for the Email Sender and Reader Snaps. Email Reader Snap updated with the Attachment folder property to store the attached files on a path. Email Sender Snap extended support to SLDB, SFTP, and SMB file protocols for the attachments 4.9.10 snapsmrc405 - Latest Upgraded with the latest SnapLogic Platform release. 4.8.0 Patch email2816 - Latest Addressed an issue with Email Sender Snap being unable to Handle Chinese characters. 4.8 - - Stable Upgraded with the latest SnapLogic Platform release. 4.7.0 Patch email2499 - Latest Added logic to process emails that have text files as attachments and download the files to the provided attachment location. 4.6.0 snapsmrc362 - Latest Resolved an issue in Email Sender Snap that failed when attached a file that had spaces in the file name. Enhanced error handling in Email Reader Snap to appropriately route connection errors to error view. 4.5.1 email1564 - Latest BCC field added to the Email Sender Snap. Retries added to the Email Sender Snap. - - August 7, 2015 (2015.25/4.2.1) - Email Reader Snap now has an option to read older message first. Resolved Null Pointer exception in Email Reader Snap when reading from Yahoo mailbox. - - June 27, 2015 (2015.22) - Email Sender now supports the ability to pass through input documents. - - June 6, 2015 (2015.20) - Email Reader: Resolved an error with concatenating file names in attachments - - Snap Updates, December 20, 2014 - NEW! Email Archive introduced in this release. - - November 2014 Launch Updates - NEW! Email Delete Snap was introduced in this release. - - October 18, 2014 - Email Sender now allows JSONPath expressions - - Fall 2014 Launch Updates - Email Sender: better handling of error messages to the error view. - - December 2013 Launch Updates - Email Reader Snap and Email Sender Snap were updated to handle attachments. - - September 2013 Updates - Email Sender & Email Reader introduced in this release. This pair of Snaps let you send and receive an email when you run a pipeline. Updated and certified against the current SnapLogic Platform release.org.json.json library from v20090211 to v20240303, which is fully backward compatible.file:/// protocol in the Attachments field.NullPointer Exception.User is authenticated but not connected, as the Snap did not re-authenticate with the server after the connection expired due to the long durations in the execution of Ultra Pipelines.