Set Up Google Workspace Sync

Syncing Pingboard with your company's GSuite account enables single sign-on for Pingboard through Google, imports employee Profiles, and displays Google Calendars in employee Profiles. Once the integration is set up you can easily manage who is synced from your Google Workspace account, and enable automatic invites for any new Profiles synced from Google.

Before you start, make sure you have:

  1. Admin access to Pingboard.
  2. Admin access to your organization's Google Workspace account.
  3. Enabled API Access Setting in Google Workspace (under Security > API Reference in your Google Workspace account).

Note: Making big changes to your data in Pingboard? Consider downloading an Everything Report before completing your setup. That report will serve as your account backup to revert to in case of any mapping accidents or surprises in your sync.

Once you have all those things in order, follow these steps in your Pingboard account to set up your Google Workspace integration:

  1. Select Account > Add Ons from the left side menu
  2. Choose the Google Workspace integration, then use Set Up
  3. Use Sign in with Google and enter your email and password

Once you've been authenticated, the sync will immediately start.

Most initial syncs take about 30 minutes to an hour, but depending on the status of Google's servers it may take a bit longer. Feel free to navigate away from the page while you wait for your colleagues to be synced.

Once the initial sync is finished, you can manage your syncing preferences on the Manage Sync page:

screengrab of the settings menu for a Google Workspace integration with Pingboard.
  1. To select which Organizational Units are synced, select Manage OU Sync and select only the OUs that you'd like to sync to Pingboard.
  2. To sync specific employees, select Choose Specific Employees - you'll be shown a list employees available for syncing and can choose from that list to make sure everyone who shouldn't be synced is removed right away.
  3. Under Data Options select Overwrite existing data if you want data from Google profiles to automatically overwrite what's in Pingboard, or choose Only add new data to fill only blank fields in Pingboard Profiles.
  4. Select Automatically Invite New Employees to automatically send invite emails to any new employee added by your Google Workspace sync.
  5. Select Show Google Calendar on Profiles to display a summary of Google Calendar events on each employee's Pingboard profile - only events and calendars with "Public" visibility in Google Calendar will be displayed.
  6. If you're using the Status add-on for Pingboard, select Create Google Calendar for Status Updates to sync statuses from Pingboard to GCal on a shared calendar for your entire organization.
  7. Create additional, specific calendars in Google Calendar by typing the names of Groups, Locations, and Departments into the Team Calendars section - those calendars will only appear to members of those groups in Pingboard so that everyone can focus on events pertinent to them in GCal.
  8. Use Save at the bottom of the page to complete your setup.


Warning: Remember to disable employee editing for all fields synced from Google Workspace, especially the Email field. If an employee's Email field is edited manually in Pingboard, their connection with Google Workspace will be broken since it will no longer match that employee's Gmail address.

Tip: Default settings will use data from Google Workspace to update blank fields, and will not overwrite existing data in Pingboard. To overwrite synced fields in Pingboard with each new sync from Google, turn on the Overwrite setting on the Google Workspace Settings page of your account.

Still need help? Let us know.