This documentation describes a release under development. Documentation for the latest release, 3.6.2, can be found here.

IMAP - Gmail - Setup Account

Mitto uses OAuth 2.0 to gain access to the contents of your Gmail account. This requires the creation of an “app” that will act on your behalf in the Google Cloud Console. Once the app has been created, the credentials associated with the app are used to authenticate Mitto to Gmail when your IMAP job(s) run.

This page will walk you through the steps necessary to create your app within GCP. At a high level, those steps are:

1. Create a project

2. Enable the Gmail API

3. Configure a OAuth consent

4. Create credentials for the app

Note

You only need to create one “app” within Google Cloud, regardless of the number of IMAP jobs you wish to create. In general, you’ll need one app per Gmail address that you wish to work with.

Create a GCP Project

1. Login to Google Cloud Console using the Gmail ID you wish to use with your IMAP by navigating to this link:

   https://console.cloud.google.com/

   

2. After login, the main GCP dashboard will appear. Your contents will differ from those shown below.

   

3. Start creating a project

   1. Click the pulldown at the top left of the page.

   2. A “Select a project” popup will appear

   3. Click “NEW PROJECT” in the top right of the popup

   

4. Finish creating your project.

   1. In the “New Project” popup that appears

   2. Enter a project name, we’ll use “mitto-imap-example” in this example.

   3. Click “CREATE”

   4. A notification popup will appear stating that the project is being created. It may take a few minutes for the project to be created.

   

5. Make the new project active by choosing it from the project pulldown at the top left of the page.

Enable Gmail API

1. Enable the Gmail API for the project. From the hamburger icon at the top left of the page, follow “API & Services –> Library” to open the Library page.

   

2. Find “Gmail” in the list of APIs and click the icon.

   

3. On the Gmail API page, click “ENABLE”.

   

Configure OAuth Consent

1. Under “APIs & Services” on the left, click “OAuth consent screen”. On that start page

   1. Click “External”

   2. Click “CREATE”

   

2. On page 1 of “OAuth consent screen” provide the minimum necessary information for your app: “App name”, “User support email”, and “Email addresses”. Click “SAVE AND CONTINUE”.

   

3. On page 2 of “OAuth consent screen”, “Scopes”

   1. Click “ADD OR REMOVE SCOPES”

   2. Select the scopes shown in the image below

   3. Click “UPDATE”

   4. Click “SAVE AND CONTINUE”

   

4. On page 3 of “OAuth consent screen”, “Test users”

   1. Click “+ADD USERS”

   2. Enter the Gmail address used with the job

   3. Click “ADD”

   4. Click “SAVE AND CONTINUE”

   

5. On page 3 of “OAuth consent screen”, “Summary”, click “BACK TO DASHBOARD”.

   

Create Credentials (an “App”)

1. Select “API & Services –> Credentials” to open the Credentials page.

   

2. An empty Credentials page will be displayed. Click “+CREATE CREDENTIALS –> OAuth client ID”.

   

3. Complete the “Create OAuth client ID” page:

   1. Select “Web application” from the pulldown.

   2. Enter a name for your app.

   3. Under the “Authorized redirect URIs” section of the page, click “+ADD URI” and enter the OAuth redirect for your Mitto instance. This should be the url of your Mitto instance with /api/oauth_redirect at the end.
      Example: https://your-mitto.zuarbase.net/api/oauth_redirect If you have more than one Mitto instance, you can add a URI for each instance.

      Important: your URI must end with /api/oauth_redirect.

   4. Click “CREATE” at the bottom of the page.

   

4. A “OAuth client created” popup will appear. Click “DOWNLOAD JSON” to download the credentials for this application.

   IMPORTANT: Keep these credentials – you will need them later when using the IMAP wizard to create IMAP jobs.

   

Note

You have successfully configured an app within GCP that can be used with Mitto’s IMAP job.