Connecting a Gmail account with JesterCrow

Using Google APIs, you can connect Google services such as Gmail with JesterCrow. To do this, you must have a valid Google account and use JesterCrow 21.1 or a newer version.

The procedure consists of the following tasks:

• Connecting a Gmail account with JesterCrow
  • Set up a new project in your Google account
  • Set up a new consent screen
  • Set up your OAuth client ID
  • Connect your Gmail account with JesterCrow

Set up a new project in your Google account

Projects store the settings, permissions, and other metadata necessary for connecting your Google account with JesterCrow.

1. Log in to your Google account and open the Google Cloud console in the same browser.
2. Click Select a project and then click New project.
3. Enter the project name and organization, and then click Create.

Set up a new consent screen

Once you've created your new project, you need to set up your OAuth consent screen.

1. In the Google Cloud console, select the project that you've just created.
2. Go to API & Services and select OAuth consent screen.
3. Select the preferred user type (Internal or External), depending on how your organization and its users are configured in Google Workspace.
4. Click Create.
5. In the App information screen, enter the following information:
   • App name — The name of the app requesting consent.
   • User support email — An email address for users to contact you with questions about consent and permissions.
   • App logo — Upload an image (not larger than 1 MB) that will help users recognize your app on the consent screen.
6. In the Authorized domains section, click Add domain and enter jestercrow.biz.
7. In the Developer contact information section, enter the email address that Google can use to notify you about changes to your project.
8. Click Save and Continue.

Set up your OAuth client ID

This step makes JesterCrow visible to the OAuth servers.

1. Log in to JesterCrow and go to Settings > API > Google API.
2. Copy the link from the Redirect URI field.
3. Go to the Google Cloud console and open Credentials.
4. Click Create Credentials and select OAuth client ID.
5. In the Application type dropdown menu, select Web application and enter the name of your app.
6. In the Authorized redirect URIs section, click Add URI, paste the link you copied from JesterCrow, and then click Create.
7. In the OAuth client created dialog box, copy the Client ID and Client Secret values. Paste them into the corresponding fields in the Google API module in JesterCrow and click Save.
8. Click OK to close the OAuth client created dialog box in the Google Cloud console.

Connect your Gmail account with JesterCrow

Now that you've established the API connection between Google Cloud and your JesterCrow instance, set up your email account in JesterCrow.

1. Go to Settings > User and open the administrator account.
2. In the Edit Administrator section, add your email address to the Email field and click Save.
3. Go to User Data > Contacts and open the administrator contact.
4. In the Contact details section, add the same email address and click Save.
5. Go to Settings > System > Email accounts and click New to add a new entry.
6. Enter the following information:
   • Email address — The address you previously added.
   • Password — Enter your JesterCrow password.
   • IMAP server — imap.gmail.com
   • IMAP port — 993
7. In the SMTP section, enter the following information:
   • SMTP server — smtp.gmail.com
   • SMTP port — 587
   • SMTP authentication — Google OAuth
8. Click Save.
9. Go to the homepage and click Edit profile.
10. In the Email address dropdown menu, select Gmail and enter your email address.
11. Click Authorize.
12. On the consent screen, accept the terms.
13. To verify your setup, click Send test email.