Fix “Sync failed”
When a sync doesn't complete it is almost always one of five things. Check them in this order.
A failed sync shows on the Contacts page and in Settings. Work down this list; the first four cover nearly every case.
| Cause | What to do |
|---|---|
| Admin SDK API not enabled | In Google Cloud Console, open APIs & Services → Library, find Admin SDK API and press Enable. |
| Wrong or missing scope | In Google Admin → Manage Domain Wide Delegation, the scope must be exactly https://www.googleapis.com/auth/admin.directory.user.readonly. Nothing more, nothing less. |
| Wrong admin email | The Workspace admin email in Settings must be a Google Workspace super admin, not the service account’s own address. |
| Google hasn’t applied the change yet | Wait five minutes after authorising in Google Admin, then press Sync now again. |
| Damaged key | Paste the entire JSON key file again, unmodified, and save. |
Still failing?
Open the chat from the bottom-right corner of this page and tell us the time of the failed sync. We can see the exact error on our side and will tell you which of the five it is.
Already-synced people are not affected by a failed sync. They stay in the directory; only new changes wait until the next successful run.
Was this page helpful? Thanks. That tells us what to rewrite.
Tell us what was missing at support@workspace-sync.com.