Skip to main content
Google Admin - Service Account Connection
Updated over 3 months ago

By creating a Google Service Account and connecting to SigParser, a single Google connection can access multiple mailboxes, contacts and calendars in your organization.

The mailbox owners do not need to create SigParser accounts or manually connect their mailboxes. You can add or remove mailboxes from your Google Admin Account.

Recommended for connecting 10+ mailboxes.

To Start

  • You must have access to the following:

    • A SigParser account. Either create an account or have access to your organization’s SigParser account with the permissions needed to add users and connect mailboxes.

    • Admin access for your organization’s Google Cloud Console

    • Admin access to your organization’s Admin Center

    • A list of the email addresses you wish to connect and scan in SigParser

    • Use the instructions page in SigParser to copy/paste the necessary values.

    • If you need additional support, you can schedule a help session HERE. Have the above items configured prior to your scheduled call.

Watch the following video for additional information:


Go to SigParser

  • In your SigParser account, go to Mailboxes > +Add > Connect Mailboxes with admin > Create New Connection > Google Cloud - Service Account


Create a Google Cloud Project

    • Project name: SigParserMailboxes

    • Organization: Select your organization from the list

    • Location: Select the parent organization or folder

  • Select Create


Enable Google API Services

    • Select the SigParserMailboxes project from the drop-down menu in the top left of the page.

  • Search and enable the following APIs for the SigParserMailboxes project:

    • Gmail API

    • Google Calendar API

    • Google People API


Create a Google Service Account & Download JSON File

  • Go to this Google Service Account page to create a service account

  • Enter the details:

    • Service account name: SigParserServiceAccount

    • Service account description: A service account for SigParser to access data

  • Select Done (you can skip the optional steps)

  • Select the three dots on the right side of the new SigParserServiceAccount

  • Select Manage keys

  • Select Add Key > Create new key

  • Choose JSON (this will download the JSON file to your computer)

  • Select Create


Add ClientID and Scopes to Google Admin Portal

  • At the top of the screen, select Add New

  • Open the Service Account JSON file on your computer and copy the client_id value from the file

    • (the client_id value will look like a number such as 5156156156156156)

  • Paste the client_id into the Client ID textbox

  • Copy and paste the following text into the OAuth scopes textbox

https://www.googleapis.com/auth/gmail.readonly, 
https://www.googleapis.com/auth/contacts, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/calendar.events.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/admin.directory.group.member.readonly, https://www.googleapis.com/auth/admin.directory.group.readonly, https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/directory.readonly
  • Select Authorize


Copy & Paste Google JSON File Contents

  • Copy and paste all of the JSON file contents into the text box on the SigParser instructions page


Name Connection

  • Add a Connection Name (e.g. SigParser Google Connection) in the textbox on the SigParser instructions page.


Enter Email Address

  • Enter an email address of a member’s account from your organization (to establish a connection) in the text box on the SigParser instructions page.


Create & Test Connection

  • Select Create & Test Connection on the SigParser instructions page.

    • If prompted to purchase a history scan for this mailbox, select No History

  • The mailboxes will automatically start processing 90 days of history within a few hours

  • To manage your connection moving forward, go to Mailboxes and select the connection under the column “Connection.”


Connect More Mailboxes

To connect more mailboxes with this connection:

  • Select the SigParser Mailboxes group

  • Select Add Members

  • Add the mailboxes you want to connect to SigParser

  • In SigParser, go to Mailboxes > under the "Connection" column, select the Google Admin Connection

  • Select the Resync button at the top of this page

  • You should see the mailboxes added at the bottom of this page.


If you have any questions, send us an email at support@sigparser.com. You can also book a demo session HERE.

Did this answer your question?