Skip to main content
Feedback

Email connection

This topic provides a step-by-step tutorial for creating an Email connection.

info

According to Google, starting May 30th, 2022, and according to Microsoft beginning September 1st, 2022, third-party apps or devices that require users to sign in using only a Username and Password will no longer be supported. This restriction has an impact on both Google Workspace and Personal Gmail, which could lead to a connection error. To address this issue, refer to this section.

Prerequisites

  • Create an email account.

Connection procedure

You can connect to an Email using one of three methods:

  • Gmail OAuth2
  • Outlook OAuth2
  • Credentials

Gmail OAuth2

To connect to your Google account, follow the steps below:

  1. Enter the Connection Name.
  2. Enter your Google Workspace Email Address.
  3. Select the Gmail OAuth2 credentials type.
  4. Click Sign in with Google (make sure your browser doesn't block pop-ups).
  5. Select Advanced and click Go to Data Integration (temporary procedure).
  6. Enter your Username and Password.
  7. Use the Test Connection function to see if your connection is up to the task. If the connection succeeded, you can now use this connection in Data Integration.

How to handle "This App Is Blocked" error message

When using the Gmail OAuth2 Credentials type, you may receive an error message while attempting to connect to Gmail due to company policies that restrict the addition of third-party applications without explicit approval.

To resolve this issue for Google Workspace accounts, follow the below steps provided:

If you are the administrator of your Google Workspace account, you can adjust the settings by following these steps. Otherwise, share this article with your administrator for assistance.

  1. Go to Security > Access and data control > API controls (https://admin.google.com/ac/owl) in your Google Workspace account.

  2. Click Manage Third Party App Access.

  3. Select Configure New App.

  4. Use the following Client ID for Data Integration:

    934654080921-3if83vsmral3pp3gcrdoh5s74n6agihe.apps.googleusercontent.com and click Search.

  5. Select the Data Integration app.

  6. Choose the option Trusted: can access all Google services before clicking Configure.

  7. Look for the Verified symbol.

  8. To establish a successful connection, refresh the Email New Connection page in Data Integration.

note

Personal Gmail accounts are currently not supported.

Outlook OAuth2

To connect to your Microsoft account, follow the below steps:

  1. Enter the Connection Name.
  2. Enter your Email Address.
  3. Select the Outlook OAuth2 credentials type.
  4. Click Connect To Microsoft Account (make sure your browser doesn't block pop-ups).
  5. Enter your Username and Password.
  6. Use the Test Connection function to see if your connection is up to the task. If the connection succeeded, you can now use this connection in Data Integration.
note

If you receive this error message:

Could not connect to Email: Could not generate token. Check your credentials. Error message:
"error_code: invalid_grant, error_description: AADSTS50079

This may be due to a configuration change made by your administrator. In this case, simply re-connect to your account.

Credentials

To connect to any other account, follow the below steps:

  1. Enter Connection Name.
  2. Enter your Email Address.
  3. Choose the Credentials type.
  4. Enter your Password.
  5. Enter your Imap Server.
  6. Use the Test Connection function to see if your connection is up to the task. If the connection succeeded, you can now use this connection in Data Integration.
On this Page