This article provides instructions for connecting Google Gmail to your Akooda account. This connection essentially provides Akooda with access to emails that were sent to a specific destination inbox under your organization’s Google Workspace account. The resulting interactions will be shown only to email recipients in the original correspondence.
In case you need guidance on how to share emails to Akooda, after you complete the integration, check out the "Emails Guide".
For more information about how Akooda helps your organization evolve and the inherent privacy and security protections in place, see Akooda Integration Principles.
NOTE: The Gmail app is currentlly in beta version. It is separate from our baseline Google Workspace app (for Drive and Calendar), and is undergoing the Google verification process. Until that point, you will need to authorize it as an unverified third party in step 2.
Before We Begin
Before connecting your organization’s Google Gmail, check that:
You’re an Admin in Akooda.
You’re an Admin for your Google Workspace account with “Users > Write“ permissions.
If you don’t have the right permissions as mentioned above, please send this guide to the right individual in your organization (usually this is IT or Info Security personnel). If you require further assistance getting the right permissions, please don’t hesitate to contact our support team at [email protected].
NOTE: At any point, if the Google Workspace user is deleted or admin access permissions are revoked, your Akooda sync will stop working and will require re-connecting by following this guide’s steps.
How to Connect
Step 1: Add Google Workspace User
If you haven’t already, follow steps 1 and 2 in the Google Workspace connector guide.
Step 2: Link the Google Workspace User with Akooda
Sign into Akooda (app.akooda.co) with your admin user.
Navigate to the “Apps” page under the Account Settings (app.akooda.co/settings/apps)
Click on the “Connect” button for Google Gmail, which will open a user selection page.
Sign in with the newly created Akooda user (called “Akooda App”, with Akooda@[YOUR_EMAIL_DOMAIN] email).
Ensure all of the checkboxes of required permissions are ticked on (see note below).
Click “Allow” to provide consent for Akooda to view the information needed to connect to Google Gmail.
Important!
Please ensure to use the designated Akooda integration account (akooda@[YOUR_EMAIL_DOMAIN]) for a successful setup.
Using a different account risks integration failure and could require a restart of the entire process.
Step 3: Send Emails to the Linked User
Anyone from your organization can manually send emails (as TO, CC/BCC or FWD) to the Akooda@[YOUR_EMAIL_DOMAIN] email set up in step 1 to be captured by the platform as interactions.
There are also configuration options to reduce the hassle and include Akooda in your correspondence without any additional steps on the day-to-day. Check out the "Emails Guide" or Contact your account manager to learn more about how you send correspondence to Akooda automatically, depending on your email client and configuration rules.
NOTE: Email interactions in their descriptive form will be shown only to the recipients' list in the original email.
Next Up
Scanning your organization's data post initial integration may take up to 24 hours. Once done, you will be able to see tagged Google Gmail interactions data sent to the above-mentioned inbox in your Akooda account.
If you run into any problems, we’re here to help. Reach out to [email protected] to get assistance for your organization (according to each email’s recipient list).
Any Feedback?
Was this page helpful? Provide feedback on this article and ways we can improve to [email protected].