Read Email

In this article

Overview

You can use this Snap to read Exchange Online user emails from a specified folder.

Snap Type

Read Email is a Read-type Snap that marks an email as read.

Prerequisites

  • Valid Exchange Online tenant.

  • Valid OAUth2 application in Azure Active Directory with all the required API permissions.

Support for Ultra Pipelines

Works in Ultra Pipelines. 

Limitations & Known Issues

None.

Snap Views

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input 

Document



  • Min: 0

  • Max: 1

  • Mapper Snap

  • Copy Snap

A document containing the email folder from which you want to retrieve the emails.

Output

Document

Binary



  • Min: 2

  • Max: 2

  • Binary  Snap

  • Mark Email as Read Snap 

Document containing a list of emails from the target mailbox.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter when running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab:

  • Stop Pipeline Execution: Stops the current Pipeline execution when the Snap encounters an error.

  • Discard Error Data and Continue: Ignores the error, discards that record, and continues with the remaining records.

  • Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in Pipelines.

Snap 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 field set.

  • Remove icon (): Indicates that you can remove fields from the field set.

Field Name

Field Type

Description

Field Name

Field Type

Description

Label*

 

Default Value: Read Email
Example: Read Email

String

Specify the name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your Pipeline.

User/Shared MailBox

 

Default Value: N/A
Example: john.doe@snaplogic.com

String/Expression

Specify the mailbox from which you want to retrieve the list of emails. Alternatively, click the Suggestionicon to select the email folder in the mailbox. For example, custom/subfolder.

Recommendation

If you do not provide a user/shared mailbox, the mailbox associated with the user account of the OAuth2 User account (signed in user) is considered. However, if you use an OAuth2 Application account, you must select a User/Shared Mailbox to retrieve the mailboxes associated with the user.

 

Email Folder*

 

Default Value: Inbox
Example: Sent Items

String/Expression

Enter the name of the email folder.

Filter Conditions

Use this fieldset to specify the email filter conditions you want to include. Click + to add a row.

Email Field

 

Default Value: N/A
Example: From

String/Expression

Specify the email field’s name upon which to apply the filter.

Available options are as follows:

  • From

  • Subject

  • Body

  • RecievedDate

Operator

 

Default Value: N/A
Example: eq

String/Expression

Specify a conditional operator.

Available options are as follows: 

  • eq

  • ne

  • gt

  • lt

  • le

  • startswith

Email Field Value

 

Default Value: N/A
Example: Subject

String/Expression

Specify a value for the email field to add a condition.

Fetch only focused emails

 

Default Value: Deselected

Checkbox

Select to retrieve the emails which are marked as Focused.

This is applicable only in the inbox folder.

Fetch only unread emails 

 

Default Value: Deselected

Checkbox

 Select to retrieve the mails to retrieve only unread emails.

Older messages on top

 

Default Value: Deselected

Checkbox

Select to sort the older messages by date.

Download attachments

 

Default Value: Deselected

Checkbox

Select to download attachments into binary output view. If not selected attachments will not be downloaded.

Mark email as read

 

Default Value: Deselected

Checkbox

Select to mark the email as read.

Number of Messages to Fetch

 

Default Value: N/A
Example: 1

 

Integer/Expression

Enter the maximum number of messages to be retrieved.

If left blank, then it fetches all messages.

Snap Execution

 

Default Value: Validate & Execute
Example: Execute only

Dropdown list

Select one of the three following modes in which the Snap executes:

  • Validate & Execute. Performs limited execution of the Snap and generates a data preview during Pipeline validation, then performs full execution of the Snap (unlimited records) during Pipeline runtime.

  • Execute only. Performs full execution of the Snap during Pipeline execution without generating preview data.

  • Disabled. Disables the Snap and all Snaps downstream from it.

Troubleshooting

Error

Reason

Resolution

Error

Reason

Resolution

Select valid MailBox Email ID

The email ID you have provided is invalid.

Verify and enter the correct email ID.

Select valid Email Folder Name

The name of the Email Folder you have provided  is invalid.

Verify and enter the correct name of the email folder.

Examples

To manage an email in a mailbox

We are using an example of email management, where we have chain of email Snaps functioning respectively to perform tasks for the mails in the mailbox. 

In this example, our Pipeline activities are as follows:

  1. Reading and email using Read Email Snap.

  2. Marking email as read using Mark Email As Read Snap.

  3. Copying document stream using Copy Snap.

  4. Flagging an email using Flag Email Snap.

  5. Moving an email using Move Email Snap.

Here, let us look into Read Email Snap in this Pipeline.

We read an email from a mailbox, wherein we provide all the required details in the Snap Settings shown below:

Read Email Snap

Output

Read Email Snap

Output

 

Upon execution, we see an output with email details from the desired folder.

Here, let us look into Flag Email Snap in this Pipeline.

We flag an email from a mailbox, wherein we provide all the required details in the Snap Settings shown below:

Flag Email Snap

Output

Flag Email Snap

Output

 

Upon execution, we see an output confirming flagging the desired email.

Here, let us look into Move Email Snap in this Pipeline.

We move an email from one folder to another folder, wherein we provide all the required details in the Snap Settings shown below:

Move Email Snap

Output

Move Email Snap

Output

 

Upon execution, we see an output confirming that the email has moved to the destination folder.

Download this Pipeline. 

Downloads

Important Steps to Successfully Reuse Pipelines

  1. Download and import the Pipeline into SnapLogic.

  2. Configure Snap accounts as applicable.

  3. Provide Pipeline parameters as applicable.

  File Modified

File Read Email. Flag Email. Move Email .slp

Nov 15, 2020 by Siddharth Menon

Snap Pack History


See Also