PSA Sync Issues

Autotask, ConnectWise, and HaloPSA synchronization errors and resolution steps.

Written By Victor Raessen

Last updated 6 days ago

PSA Sync Issues

Troubleshooting data synchronization problems between Salesbuildr and your PSA (Autotask, ConnectWise Manage, HaloPSA).

Checking sync status

The primary place to monitor and resolve sync issues is Admin > Tools > Issues. Each failed sync creates an issue with:

  • The entity that failed (quote, company, contact, opportunity)

  • An error message explaining what went wrong

  • Options to Retry, Dismiss, or investigate further

Successful syncs automatically clear their corresponding issues.

Autotask: BillingCode errors

The most common Autotask error. Appears when a product category in Salesbuildr is not mapped to a valid Autotask billing code.

  • Symptom: "BillingCode does not exist or is invalid"

  • Cause: The category's billing code mapping is missing or points to a deleted/inactive billing code in Autotask

  • Fix: Go to Admin > Integrations > Autotask > Category Billing Codes and verify each category has a valid billing code assigned

Autotask: Entity not found

Error

Cause

Fix

"Opportunity was not found in Autotask"

The linked opportunity was deleted or deactivated in Autotask

Verify the opportunity exists and is active in Autotask, then retry

"Company has no external identifier"

The company hasn't been synced to Autotask yet

Sync the company first (it should happen automatically on next action)

"Contact has no external identifier"

The contact hasn't been synced to Autotask yet

Sync the contact first, or check that the contact is linked to the right company

"companyID is not associated with contactID"

The contact and company are linked in Salesbuildr but not in Autotask

Verify the association in Autotask, then retry

Autotask: Authentication errors

  • "Autotask authentication error: please verify your credentials" — The Autotask API credentials have expired or been changed. Re-enter them at Admin > Integrations > Autotask.

  • Connection reset errors — Temporary network issues. Salesbuildr automatically retries up to 2 times. If persistent, check Autotask service status.

Autotask: Opportunity status/stage not syncing from Autotask to Salesbuildr

Salesbuildr does not sync changes made to existing opportunities in Autotask. This is a deliberate limitation, and understanding why requires a brief look at how the Autotask API works.

Autotask does not currently support webhooks for opportunities. Webhooks are the standard mechanism for receiving real-time notifications when data changes — without them, the only alternative is polling. Polling means repeatedly calling the API at set intervals to fetch all opportunities and compare them against what was previously retrieved to identify any changes.

While polling works in theory, it is not practical at scale. Many Salesbuildr customers manage thousands of opportunities in Autotask. Polling all of them at a reasonable frequency would consume a large share of the 10,000 API calls per hour that Autotask permits. This would leave insufficient capacity for the rest of the integration — including product, contact, and agreement syncing — and would risk degrading the reliability of the integration as a whole.

Until Autotask introduces webhook support for opportunities, syncing opportunity changes in real time is not possible without compromising the broader stability of the integration.

ConnectWise: Rate limit errors

  • "ConnectWise API rate limit exceeded" — Salesbuildr hit the ConnectWise API rate limit. The system retries automatically with exponential backoff (5s, 10s, 20s, up to 60s). If the error persists after 4 retries, wait a few minutes and retry manually.

General sync failures

  • "Already synchronizing" — The entity is currently being synced. Wait a few minutes and check the status again.

  • Some line items not synchronized — The quote synced but individual items failed. This is a warning, not a critical error. Check which items failed and verify their product mappings.

  • "Payment term/type is deleted" — A referenced payment term or type was deleted in the PSA. Select a different payment term in the quote settings.

For PSA-specific configuration, see Autotask Configuration, ConnectWise Configuration, or HaloPSA Configuration.

See also