Skip to main content
info
This documentation is for version v2.5 of the product.
For the latest version(v2.7) documentation click here
Version: v2.5 print this page

Email Connections

Email connections enable users to seamlessly ingest data sent over emails as attachments, directly into Amorphic Datasets.

How to create an Email Connection?

An email connection can be created using an email address as follows:

Email Connection Creation

Here is a description of all the fields required for creating an Email Connection:

AttributeDescription
Connection NameGive your connection a unique name.
Connection TypeType of connection, in this case, it is Email.
DescriptionYou can describe the connection purpose and important information about the connection.
Email AddressEmail Address of the recipient.
Enable ScanEnable/Disable this option to scan incoming emails for spam and viruses. This option is disabled by default.
Enable TLSEnable/Disable this option to reject any incoming emails that aren't sent over a secure connection. This option is disabled by default.
Note

Enable Scan, Enable TLS and Description are the only attributes that are editable after connection creation.

After the successful creation of an email connection, the user will receive a confirmation email from SES at the provided email address. Furthermore, the necessary DNS records will be available on the connections page. These records are essential for updating the DNS configuration, enabling the redirection of incoming emails to the specified email address. DNS Records

Note

Multiple email connections cannot be created using the same email address.

Test Connection

This functionality allows users to quickly verify the correctness of the provided email address. By initiating this test, users can confirm whether the email address provided is correct and the DNS configurations made are functional, ensuring seamless redirection of the emails. Test Email Connection

Data migration to Amorphic

To migrate data to Amorphic, users must create a new Dataset. They should select the Connection Type as 'Email' and subsequently choose the Email connection from the provided drop-down list. During dataset creation, users are restricted to choose FileType as 'others' and target location as 'S3'.

Moreover, additional parameters can be provided if required. The allowed parameters are:

  • EnableBodyExtraction: Enables or disables the extraction of email body content. It accepts 'yes' to enable or 'no' to disable. This functionality exclusively extracts text content from the body of the email and does not include elements such as inline images, embedded videos, formatted text styles, etc.
  • BodyFileType: Specify the file type for the extracted email body. Users are provided with the option to select from JSON, TXT, or PDF formats. In cases where no file type is explicitly provided, the default setting will use JSON format.
  • AllowEmailsFrom: Filter to allow emails only from specified email addresses.
  • ExcludeEmailsFrom: Filter to exclude emails from specified email addresses.
  • AllowEmailDomains: Filter to allow emails only from specified domains.
  • ExcludeEmailDomains: Filter to exclude emails from specified domains.
  • AllowFileTypes: Filter to allow only specific file types for the dataset.
  • ExcludeFileTypes: Filter to exclude specific file types for the dataset.

Email Connection Dataset Creation

Note

Additional Parameters can be modified or removed while editing the dataset.

After successful dataset creation, the user can send emails to the email address and the attachments would be ingested to the dataset.