Skip to main content
When a CRM connection shows a needs-attention status, records can stop flowing or attribution can break, which quietly affects partner reporting and commissions. Most issues come down to one of three things: authorization that expired, a new permission scope HubSpot or Salesforce now requires, or a sync filter that excludes the records you expect. This guide walks the checks in order so you can restore a healthy sync fast.

​
What you’ll achieve

A healthy, syncing CRM connection: the status returns to connected, the records you expect appear as partners again, and attribution resumes flowing to the CRM.

​
Before you start

1

Read the connection status

On the Integrations page, note the tile’s status pill: Connected, Update available, Needs attention, Rate limited, Interrupted, or Not connected. The pill points you at the likely cause.
2

Confirm your permission

You need permission to manage integrations in Introw to re-authorize or change sync settings.

​
Watch it

​
Steps

1

Open the connection detail

Go to Integrations, then open the CRM via Configure to see the detail header. A red Connection has been interrupted banner means authorization broke; an amber Syncing state is normal and just means a sync is running.
Open the connection detail
2

Reconnect or install updates

If the connection is interrupted, select Reconnect and complete the OAuth flow again, accepting every requested scope. If the tile instead shows Update available or the header shows Install update (HubSpot) or Install package / Install update (Salesforce), run that: HubSpot needs you to re-authorize for new scopes such as quotes or certificates, and Salesforce needs the latest managed package. Missing scopes are the most common reason a specific object stops syncing.
Reconnect or install updates
3

Check the partner object and filters

If authorization is healthy but specific records are missing, the sync scope is usually the cause. Open the connection’s setup and confirm the partner object is the one those records live on, and that your filters actually include them - a too-narrow property filter or a hand-picked selection silently leaves matching records out. Widen the filter or select the missing records.
4

Wait out a rate limit

A Rate limited pill means the CRM temporarily throttled the sync; no action is needed beyond waiting for it to clear and watching the status return to connected. If it persists, contact support.
5

Confirm health

Watch the status pill return to Connected and confirm the previously missing records now appear as partners.

​
Verify it worked

The integration shows a healthy Connected status, the records you expected appear as partners, and attribution resumes syncing to the CRM.

Connect HubSpot as your source of truth

Review the connect flow, scopes, and attribution setup.

Disconnect a CRM

Reset a connection that cannot be recovered.

Implementation reference

Full configuration options.