×

Master the HubSpot integrations sync card

How to Use the HubSpot Integrations Sync Card

The HubSpot integrations sync card gives you a quick, record-level view of how data is syncing between HubSpot and your connected apps. By learning how to read and use this card, you can troubleshoot sync errors faster, understand data flow, and maintain cleaner records across your systems.

This guide walks you through where to find the sync card, what each element means, and how to use it to resolve issues when records do not sync as expected.

Where the HubSpot integrations sync card appears

The integrations sync card appears in the right sidebar on individual records when an integration that supports the sync card is connected to your HubSpot account. You’ll typically see it on:

  • Contact records
  • Company records
  • Deal records (for some integrations)
  • Custom object records (depending on the app)

If an integration is active and object syncing is enabled, the sync card offers an instant summary of how the current record relates to records in the external app.

Understanding the HubSpot sync card layout

The HubSpot integrations sync card uses a consistent layout across supported apps so you can quickly scan important sync information. While the exact labels may vary slightly by app, the card usually includes:

  • App name and status: the name of the connected app and whether syncing is active.
  • Linked external record: a reference or link to the record in the external system.
  • Last synced date and time: the most recent successful sync for this record.
  • Sync direction: whether data is one-way or two-way between HubSpot and the app.
  • Error or warning badges: quick visual indicators when something prevents the record from syncing.

From this single view, you can see if the record is syncing, when it last updated, and whether action is needed to resolve issues.

How to open and view the HubSpot sync card

To access the sync card for a specific record, follow these steps:

  1. In your HubSpot account, navigate to Contacts, Companies, or another object that syncs with your integration.
  2. Click the name of the record you want to review.
  3. On the record sidebar, look for a card labeled with the integration name, often titled with the app followed by “sync” or “integration”.
  4. Click the card or expand caret if it is collapsed to view full sync details.

If you do not see the card, verify that the integration is installed, object syncing is enabled, and that the app supports the sync card feature for that object type.

Key details on the HubSpot integrations sync card

Once you open the sync card on a HubSpot record, focus on these important elements.

HubSpot sync status and last sync details

The first item to check is the sync status. Common indicators include:

  • Syncing: the record is actively syncing with the external app.
  • Not syncing: the record is excluded from sync due to filters or settings.
  • Sync error: an error prevents data from syncing; further detail is provided on the card.

Next, look at the last sync date and time. This tells you how fresh the data is and can help you determine whether a recent change has been pushed to or from HubSpot.

Matched records between HubSpot and external systems

The card typically shows which external record your HubSpot record is associated with. You may see:

  • An external ID or name that identifies the matching record.
  • A link that opens the matching record in the external app (depending on the integration).
  • Any indication that multiple potential matches exist, in which case the app may ask you to confirm the correct one.

Confirming you are synced with the right external record is essential to prevent data mismatches.

HubSpot field mapping indicators

While full field mappings are usually managed in the integration settings, the sync card may highlight which fields recently changed or were updated during the most recent sync. This can reveal:

  • Which side was the source of truth for a particular update.
  • Whether specific critical properties, such as email address or company domain, successfully synced.
  • Any fields that failed to sync due to data formatting or validation rules.

Use this view to quickly see if a property value in HubSpot was overridden or if it did not push to the external app.

Reading and fixing HubSpot sync errors

When something goes wrong, the integrations sync card on your HubSpot record surfaces error messages, often with recommended actions.

Common HubSpot sync error types

Typical errors you may see on the sync card include:

  • Property validation errors: a field value in HubSpot does not meet the format required by the external app, such as invalid dates or phone numbers.
  • Duplicate records: the app found more than one possible match in the external system.
  • Missing required fields: a mandatory field in the external app is blank in HubSpot.
  • Permission issues: the integration user does not have access to update the external record.

The card usually displays short, plain-language messages that explain why the error occurred and often suggests how to resolve it.

Steps to resolve sync errors from the HubSpot card

When you find an error on the integrations sync card, take these steps:

  1. Read the error text carefully. Identify which field, record, or rule is causing the issue.
  2. Open the affected record. Use the link from the card to open the record in HubSpot or the external app, if available.
  3. Correct the data. Update the required property or fix the formatting problem indicated by the message.
  4. Save and trigger a resync. Depending on the integration, the record may resync automatically after you save, or you might have a button on the card to retry the sync.
  5. Confirm resolution. Refresh the record and check the HubSpot integrations sync card again to ensure the error badge is cleared and the status is back to syncing.

For complex or recurring errors, review the integration’s full settings and any logs provided in the connected app.

Best practices when using the HubSpot integrations sync card

To get the most value from the sync card on your HubSpot records, incorporate these habits into your workflows:

  • Check the card during record review. When a user views a key contact or company, encourage them to glance at the card to confirm everything is in sync.
  • Use it as a starting point for troubleshooting. Before changing integration settings globally, review a few example records and their cards to see exactly what is happening.
  • Document frequent error messages. Capture wording from repeat errors and document internally how your team should resolve them.
  • Align field requirements. Ensure that critical required properties exist and are properly formatted in both HubSpot and the external system to minimize sync failures.

These practices help your team maintain consistency across platforms and reduce time spent digging through logs or configurations.

Learn more about HubSpot integrations sync behavior

If you want to dive deeper into how the integrations sync card works for specific apps in HubSpot, you can review the official documentation and feature breakdowns. The source page for this topic is available here: view the integrations sync card documentation.

For broader strategy on how to structure data, integrate multiple systems, and optimize your setup around HubSpot, you can explore expert resources such as Consultevo, which offers guidance on implementation, data governance, and CRM architecture.

By consistently using the integrations sync card on your HubSpot records, you gain faster insights into your connected systems, reduce sync conflicts, and ensure your teams rely on accurate, up-to-date information across every integrated tool.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`

Verified by MonsterInsights