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 Xero Contacts

Sync Google Workspace Directory Users to Xero

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


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

Many businesses need their employees and contractors set up as contacts in Xero so they can reimburse expenses, pay bills, record staff purchases, or track internal recharges. Finance teams usually create these contacts by hand from details that already exist in Google Workspace. New hires are added late, changed phone numbers and addresses are never updated, and former employees stay active in Xero long after they leave. The result is duplicate data entry, outdated records, and a cluttered contact list.

How SyncPenguin helps

SyncPenguin connects your Google Workspace directory to Xero and keeps employee contacts up to date automatically. Each new user in Google Workspace becomes a Xero contact with their name, email, phone numbers, and address. Profile changes in the Google Admin console update the matching Xero contact, and departing employees are archived in Xero so your accounting history stays intact. With no-code filters and custom rules, you choose which users sync, for example only active employees or only contractors, and how fields such as the contact name or account number are filled in.

Best suited for: Finance and accounting teams. Bookkeepers and accountants managing client Xero organizations. IT administrators of Google Workspace. HR and operations managers at small and medium-sized businesses.

Real-world use cases

  • Create a Xero contact for every new employee automatically, so expense reimbursements and staff payments can be recorded from day one.
  • Archive an employee's Xero contact automatically when their Google Workspace account is deleted, or suspended using a deletion rule, to keep the Xero contact list clean.
  • Sync only active, non-archived users who are visible in the global address list and have a mailbox set up, leaving out service accounts and shared mailboxes.
  • Sync only contractors and freelancers into Xero, for example users whose job title contains 'Contractor', so they can be paid through bills.
  • Generate a consistent Xero account number for each employee with a custom rule, for example 'EMP-' followed by the email username, to simplify reconciliation and reporting.
  • Sync the same staff directory into several Xero organizations, one connection per organization, for groups running multiple legal entities.
  • Keep employee contacts current in both Xero and QuickBooks during a migration between accounting systems or across separate entities.
  • Sync the company directory into Xero for finance, and sync Xero customers into employees' Google Contacts, so everyone has colleague and client details on hand.

Key features

Automatic Onboarding

New hires added in Google Workspace become Xero contacts automatically, so finance can reimburse or pay them right away.

Targeted Filtering

Sync only the users you need, for example active users listed in the global address list, while skipping suspended, archived, or admin accounts.

Safe Offboarding

When an employee is removed or suspended, the Xero contact is archived instead of deleted, so invoices, bills, and history are kept.

Read-Only Source

SyncPenguin only reads your Google Workspace directory and never changes user accounts. Data flows one way into Xero.

Flexible Mapping

Use no-code rules to set Xero contact names, account numbers, phone types, and addresses exactly the way your finance team needs them.

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 Xero. Edits made to employee contacts in Xero are not sent back, so update user profiles in the Google Admin console and the changes will sync automatically.
  • Connecting Google Workspace requires an administrator account that can view users. Each Xero connection syncs one Xero organization, so add a connection for each additional organization.
  • Xero stores one email address per contact, so the user's primary email is synced. Up to three phone numbers are synced into Xero's work, mobile, and fax fields.
  • Google Workspace addresses are synced as a single full address line rather than separate street, city, and postal code fields.
  • Xero requires unique contact names. If a name is already taken, SyncPenguin adds the person's name in brackets after the company name so the contact can still be created. A custom rule can also set the Xero contact name to the employee's display name.
  • Departments, managers, custom user attributes, and profile photos from Google Workspace are not synced at the moment.

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 Xero Contacts for the second app.
  • Then select the sync direction.
  • Then click the Create button.

Step 3. Provide access to Google Workspace and Xero

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 Xero?

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

Account for Xero Contacts (Example)
Xero 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 Xero fields: First name Last name Contact / company name Email address Phone numbers (work, mobile, fax) Addresses (postal, street) Website (read-only) Is customer Is supplier Account number

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 Xero Contacts: take all Google Workspace Directory Users and add/merge them into Xero 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

Why would I sync Google Workspace users to Xero contacts?

Will SyncPenguin change anything in my Google Workspace directory?

What happens in Xero when an employee leaves?

Can I exclude suspended users, admins, or service accounts?

How are employee contact names created in Xero?

I already have some employees in Xero. Will they be duplicated?

How quickly do new hires appear in Xero?