Troubleshooting CleanSync

The five errors that come up most, what they mean, and how to fix them.

If something looks off, the dashboard at cleansync.io/app shows an alert at the top with the property nickname and a plain-English description. The action you need to take is right under it. Here's the longer version of each.

"Calendar link not working"

What it means. CleanSync got an HTTP error trying to fetch the iCal feed. Usually a 404 — the URL is no longer valid.

Why it happens. On Airbnb, the host clicked Reset URL in their calendar settings (this regenerates the URL and invalidates the old one). On Vrbo, the host connected/disconnected a third-party PMS that touched the calendar.

Fix. Get the new URL from the host:

  • Airbnb: Listings → [the listing] → Calendar → Availability → Sync calendars → Export calendar.
  • Vrbo: Calendar → Import & export → Export calendar.

Open the rental in CleanSync, paste the new URL into the matching field, save. The next sync picks up where it left off.

"Jobber wouldn't accept the change"

What it means. CleanSync tried to create or update a Jobber job and Jobber returned a validation error. The error row in the dashboard includes Jobber's exact reason.

Common causes:

  • Assignee no longer has access to this client. The crew member you assigned to the rental was removed from the account or had their permissions changed. Open the rental, pick a different crew member, save.
  • A required field is missing. Usually the line item name. Open the rental and confirm the service name field isn't blank.
  • Permission was turned off in Jobber. Reinstall CleanSync from the Jobber Apps page to refresh the OAuth scopes.

"Need to sign back in to Jobber"

What it means. CleanSync's OAuth tokens expired and Jobber rejected the refresh. Usually because the host changed their Jobber password, or revoked the app's authorization in Jobber's admin panel.

Fix. Open CleanSync from the Jobber Apps page (inside Jobber, click Apps → CleanSync → Open). This re-authorizes and CleanSync resumes from where it left off — no data loss.

"Couldn't finish checking"

What it means. A sync run started but didn't complete. Usually a transient network issue or a Jobber API hiccup.

Fix. Click Check now at the top of the dashboard. If the same error fires three times in a row, email support@cleansync.io with the property nickname and the time the error occurred — there's likely a deeper issue.

"Missed an update from Jobber"

What it means. Jobber sent a webhook (someone edited a job, deleted a customer, etc.) and CleanSync didn't acknowledge it within Jobber's deadline. Rare — most often happens during platform-wide outages.

Fix. Click Check now to force a full reconciliation. The next regular sync will also catch up automatically; this alert mostly exists so you know we noticed.

When the dashboard shows the error but the issue is gone

Click the X on the right side of the error row to dismiss it. The error row disappears. If the underlying problem comes back on the next sync, it'll re-appear — dismissing isn't the same as fixing.

When you should email support

Email support@cleansync.io if:

  • You see an error kind that isn't in this list.
  • The same fix isn't working after two attempts.
  • A booking exists in Airbnb/Vrbo and isn't showing up in Jobber, with no error displayed.

Include the property nickname and the time you noticed the problem — that's enough for us to look up the sync logs.

Related