Knowledge Base
  1. Home
  2. Knowledge Base
  3. Documentation
  4. Creating the Heroic Inbox Google App

Creating the Heroic Inbox Google App

The Heroic Inbox plugin requires a Google App to access Gmail inboxes, send and receive mail on behalf of the plugin.

Once the App creation is complete, a Client ID and Client Secret will be generated, which can be entered in the Heroic Inbox setup assistant during installation.

1. Register a New Project

Log into the Google Cloud Platform, click the Select a Project dropdown (the current project name may already be selected) to show the Projects in the current organization.

Accessing Google Cloud project

In the project management dialog, click NEW PROJECT.

Create new Google project

Give the project a descriptive name such as Heroic Inbox Project and click CREATE.

Google cloud platform new project details

In the notifications area, select the new project to switch to management of the new project.

Select created project from the notification area

2. Enable the Gmail API

Now the project has been created, the Gmail API needs to be enabled.

In the APIs and Services tab or Quick access shortcut, click APIS AND SERVICES, then search for Gmail.

Access APIs and Services

Select the Gmail API and click ENABLE to activate.

Accessing Gmail API

Enable Gmail API

3. Create Credentials

Once you’ve activated the Gmail API, you’ll need to create OAuth credentials.

You first need to create an OAuth consent screen, this will be displayed when you allow Heroic Inbox to access Gmail messages.

In the OAuth consent section, select the user type as Internal – this permits the app to access any accounts within the organisation. Click Create

In the App Information section set a meaningful App name, such as Heroic Inbox App. From the User support email dropdown, pick an appropriate contact email. The same Email address can be used in the Developer contact information section.

Enter the URL of the site the Heroic Inbox plugin will be used on in the Authorised domains section. All the other sections (not marked with *) do not need to completed.

Configure OAuth consent screen
Fill the App information
Add authorized domains information
Click <strong>SAVE AND CONTINUE<strong>

2. Scopes

Nothing needs to be changed from the default in the Scopes section, this will be set automatically by the App on first use.

Scopes section
Click <strong>SAVE AND CONTINUE<strong>

A summary will be displayed, review this and click to go back to the Google App dashboard.

3. Create OAuth Client ID

In Credentials Section click CREATE CREDENTIALS.

Access CREATE CREDENTIALS

Next, select Web Application as the Application type.

Select web application

Inthe OAuth Client ID section, select the Application type as Web application from the dropdown. Give the client a meaningful Name, such as Heroic Inbox WordPress Plugin.

Fill the name

Switch back to the Heroic Inbox setup assistant screen, which may look similar to the screen below to obtain the Authorised redirect URI.

The authorised redirect URI, if not displayed, is in the form example.com/wp-admin/?page=ht_desk_gmailbox_setup_callback where example.com should be substituted for your site url.

Add a Gmail mailbox
Add authorized redirect URLs
Click <strong>CREATE<strong>

5. Obtain Credentials 

Once the client has been created a dialog will appear. Copy the Client ID and Client secret into Heroic Inbox setup assistant and continue with remainder of the setup process.

Obtain Credentials
Was this article helpful?
Related Articles