LOOKING FOR PARTNERS 🤝

We're currently looking for partners and distributors in different regions. If you're interested, please feel free to contact us.

Google Workspace Directory Users syncs one-way to Freshdesk Contacts

Sync Google Workspace Directory Users to Freshdesk

Learn how to sync your Google Workspace and Freshdesk contacts using the SyncPenguin platform


Free 14-day trial with full support, no credit card required

Many companies use Freshdesk as an internal IT, HR, or facilities helpdesk, but every employee who raises a ticket needs an accurate Freshdesk contact. Without integration, these contacts are created by hand or by importing CSV files from the Google Admin console. New hires show up with missing contacts, job titles and phone numbers go out of date, and former employees stay in the helpdesk long after they leave. Agents can't tell internal requesters from customers, and IT teams spend time on manual data work instead of solving tickets.

How SyncPenguin helps

This connection makes your Google Workspace directory the single source of truth for employee contacts in Freshdesk. SyncPenguin automatically creates Freshdesk contacts for new users, keeps names, job titles, emails, and phone numbers up to date, and can remove contacts when employees leave or are suspended. No-code filters let you choose exactly which users are synced, for example only active users listed in the global address list. Custom rules can tag employees, set their company, or fill Freshdesk custom fields, so agents always know who they are helping.

Best suited for: IT administrators. Internal IT and HR helpdesk managers. Managed service providers (MSPs). Support operations managers.

Real-world use cases

  • Run an internal IT helpdesk in Freshdesk where every Google Workspace employee automatically exists as a contact, so tickets from new hires are recognized right away.
  • Sync only active employees by excluding suspended and archived accounts and including only users visible in the global address list.
  • Use deletion rules to remove a Freshdesk contact as soon as the employee's Google Workspace account is suspended or archived during offboarding.
  • Tag all synced users as "Employee" and set their company to your organization's name, so agents in a shared helpdesk can tell internal requesters from customers.
  • Map the Google Workspace "Is admin" flag to a Freshdesk custom checkbox field or a tag, so agents know which requesters can approve access and license requests.
  • As a managed service provider, sync several client Google Workspace tenants into one Freshdesk account, with each client's users linked to their own Freshdesk company.
  • Keep job titles and work and mobile phone numbers current in Freshdesk, so agents can identify callers to the IT hotline and see their role.
  • Use the same Google Workspace directory to feed both Freshdesk and the Microsoft 365 global address list, so employee details match in the helpdesk and in Outlook.
  • Sync the directory into Freshdesk for internal support and into employees' Google Contacts, so colleagues and helpdesk requesters always have the same up-to-date details.

Key features

Automatic Onboarding

New Google Workspace users become Freshdesk contacts automatically, so new hires can raise tickets from their first day.

Clean Offboarding

Remove Freshdesk contacts automatically when users are deleted, suspended, or archived in Google Workspace.

Smart Filtering

Sync only the users you want, such as active employees in the global address list, or users with a mailbox set up.

Employee Tagging

Add tags, set the company, or fill custom fields with no-code rules, so agents can tell employees from customers.

No Duplicates

Users are matched to existing Freshdesk contacts by email address, so the initial merge doesn't create duplicate requesters.

Affordable & Scalable

With SyncPenguin you only pay for changes to your data, regardless of how many contacts you have now or will have in the future.

Things to note

  • This is a one-way sync from Google Workspace to Freshdesk. Google Workspace is only read, so profile changes should be made in the Google Admin console, and they will sync to Freshdesk automatically.
  • Users are synced as Freshdesk contacts (requesters), not as Freshdesk agents.
  • Connecting requires a Google Workspace administrator account that can view users, and a Freshdesk API key and domain.
  • Freshdesk stores one work phone and one mobile phone per contact. If a user has more phone numbers, the first work number and the first mobile number are synced.
  • Departments, managers, custom user attributes, and profile photos from Google Workspace are not synced at the moment. Groups and resources such as meeting rooms are not included.
  • Freshdesk requires unique email addresses, so users are matched to existing contacts by email. Contacts deleted through the sync go to Freshdesk's Deleted contacts and can be restored there.
  • Requests are paced to stay within Freshdesk's API limits, so the first sync of a very large directory may take longer than later updates.

How to configure the sync?


This guide explains in detail how to create, configure, and start the sync.

If you'd like to start syncing right away, feel free to create an account and set up the sync on your own. Come back to this guide if anything is unclear. You can also contact us with any questions, requests, or feedback.

Step 1. Create a SyncPenguin account

The first step is to create a SyncPenguin account. We offer a free 14-day trial (no credit card required), so you can make sure everything works well before you commit. Follow the link below to create an account.

14-day free trial • no credit card required • quick setup

Step 2. Create the sync

Next, create a sync in the Synchronizations section of the dashboard by clicking the + New sync button. You'll see a wizard page where you need to do the following:

  • Choose Google Workspace Directory Users for the first app.
  • Then choose Freshdesk Contacts for the second app.
  • Then select the sync direction.
  • Then click the Create button.

Step 3. Provide access to Google Workspace and Freshdesk

Now that your sync is created, the next important step is to grant SyncPenguin access to your contact data. You'll see an Account section for each app involved in the sync. Below we explain how to connect and configure each account.

How to connect Google Workspace?

This is a preview of the connection form in your SyncPenguin dashboard, shown for illustration only. Don’t enter any credentials here.
The Google Workspace Directory Users account connection section will look like this:

Account for Google Workspace Directory Users (Example)
Google Workspace Directory Users

How to connect Freshdesk?

This is a preview of the connection form in your SyncPenguin dashboard, shown for illustration only. Don’t enter any credentials here.
The Freshdesk Contacts account connection section will look like this:

Account for Freshdesk Contacts (Example)
Freshdesk Contacts

Please make sure both apps are properly connected before starting the contact sync.

DATA SECURITY

If you're concerned about the security of your data, please check out our Security Practices page.

Step 4. Sync settings

In the Sync settings section, you can adjust some of the default settings of your sync:

  • The name of your sync.
  • Sync direction (two-way or one-way).
  • Sync interval (by default, the sync runs every 10 minutes).

Please note that this connection uses webhooks, so syncing will be near real-time in most cases. The syncing interval is used as a fallback in case a webhook was not fired.

Additionally, in Field mappings & rules you can customize how contact data is mapped between the apps, or add filters and custom rules to the sync. This is done using our simple no-code visual interface, which lets you make simple adjustments as well as implement complex custom scenarios.

Supported Google Workspace fields: First name Last name Display name Job title Company Emails Primary email Phone numbers Addresses Is admin Is suspended Is archived Is in global address list Is mailbox set up
Supported Freshdesk fields: First name Last name Full name Job title Company Emails (primary and additional) Phones (work and mobile) Address Description Tags External ID Language Time zone Active (verified) status Custom text fields Custom paragraph fields Custom number fields Custom dropdown fields Custom checkbox fields Custom date fields Custom URL fields Custom phone number fields

Virtually any syncing behavior based on supported fields is possible using the customizations interface.

Learn more about our customization interface.

Sync settings

Step 5. Start the sync

The last step is to start the sync. To do that, click the Start syncing button.

You'll then be offered the following options:

  1. Only sync new data, meaning anything added or updated from now on.
  2. Merge Google Workspace Directory Users into Freshdesk Contacts: take all Google Workspace Directory Users and add/merge them into Freshdesk Contacts.
Start sync
We'll be checking every 10 minutes for changes in your data.
What should we do initially with already existing contacts?

Once you've made your choice, click Start syncing. If you choose an initial merge, it'll be queued immediately. Once it's done, we'll check for contact changes at the sync interval you've set and sync them accordingly. Each sync run is shown in the Sync history at the bottom of the sync page.

Learn more

Frequently Asked Questions

How do I sync Google Workspace users to Freshdesk?

Can I use this to set up an internal IT helpdesk in Freshdesk?

Will employees' Freshdesk contacts be removed when they leave the company?

Will the sync create duplicates if employees already exist in Freshdesk?

Can I sync only some Google Workspace users to Freshdesk?

How can agents tell employees apart from customers in Freshdesk?

Will changes made in Freshdesk be written back to Google Workspace?