How to Set Up a Test Sync in Hubspot

Before turning on a new integration, it is essential to set up a test sync in Hubspot so you can safely preview changes, verify field mappings, and protect your live CRM data from unexpected updates.

This guide walks you through preparing your test records, enabling the test feature, reviewing results, and clearing data when you are done.

Why You Should Use a Hubspot Test Sync

Running a test sync environment lets you understand exactly how your integration will behave before it touches your real customers and deals.

A test sync in your portal allows you to:

• Preview how contacts, companies, and deals will be created or updated.
• Confirm that custom field mappings work as intended.
• Detect potential duplicates or unwanted overwrites.
• Protect production data while you fine-tune the integration.

Use this feature whenever you are setting up a new app, changing objects or properties, or modifying sync rules.

Hubspot Requirements and Limits for Test Sync

Before starting, make sure your portal meets the test sync requirements and limitations.

Supported Hubspot Subscriptions

The test sync option is available for integrations that use data sync. You must have access to the integration in your account and the permission to manage connected apps.

Confirm that you can:

• Install or configure the third-party app from the Hubspot App Marketplace.
• Open the app’s settings within your CRM.
• View object sync rules such as contacts, companies, or deals.

Key Test Sync Behaviors in Hubspot

When a test sync is enabled, the integration processes records differently than in a normal live environment:

• Only records that meet your configured filters and rules are synced.
• Changes affect your actual CRM objects, but in a limited and test-focused batch.
• You can clear all records created or updated during the test sync using a built-in cleanup option.

During the test period, carefully monitor the synced records to confirm that behavior matches your expectations.

How to Turn On a Test Sync in Hubspot

Follow these steps to enable the test sync feature for a compatible app and avoid unwanted data issues.

Step 1: Open the Integration Settings in Hubspot

1. Sign in to your account.
2. Navigate to Settings in the main navigation bar.
3. In the left sidebar, go to Integrations and open Connected apps.
4. Select the app that supports data sync, such as a contact or accounting integration.

This takes you to the configuration page where you manage sync rules and can enable the test mode.

Step 2: Configure Sync Direction and Objects

Before you start a test run, first configure what should sync between the external system and your CRM:

• Choose the sync direction (one-way or two-way).
• Select the objects to sync, such as contacts, companies, or deals.
• Define filters to limit which records are included.
• Set up property mappings between the two systems.

Spend time validating each mapping so the test run provides meaningful results.

Step 3: Enable the Test Sync Mode

Once configuration is ready, you can turn the test option on.

1. Within the selected integration, locate the data sync section.
2. Look for the option labeled Test sync or similar wording.
3. Toggle the feature to enable test mode.
4. Confirm any warning dialog that explains how test data will be handled.

After you enable this mode, only a subset of records is processed, allowing you to validate behavior before a full production run.

Preparing Test Records in Hubspot

To get accurate results from your test, you should prepare a dedicated batch of records on both sides of the integration.

Best Practices for Test Data in Hubspot

• Create sample contacts and companies specifically for testing.
• Use clear naming patterns, such as “Test – Firstname Lastname”.
• Fill in all important properties that are used in your mappings.
• Avoid using real customer email addresses or sensitive data.

In the external system, create matching test records so you can see exactly how each mapping behaves between the two platforms.

Recommended Object Types for Initial Tests

When you first try a new app, focus the test sync on high-impact objects:

• Contacts for basic identity and communication fields.
• Companies for domain-based associations.
• Deals for pipeline stages and revenue-related fields.

Once your core objects sync correctly, you can extend testing to additional objects or custom entities where supported.

Monitoring Your Hubspot Test Sync

After you activate test mode and create your sample records, monitor the results closely to catch any mapping or filter issues.

Review Synced Records Inside Hubspot

1. Open the relevant object index page, such as Contacts or Companies.
2. Filter by your test naming pattern or specific email domains.
3. Open individual records and verify that properties populated correctly.
4. Check associations between objects, such as contact-to-company or deal relationships.

Compare values between both systems to confirm that the integration behaves exactly as you expect.

Check Sync Logs and Status

From the integration settings, review the synchronization status and any log entries that may indicate issues:

• Look for records that failed to sync and read any error messages.
• Confirm that records created in the external app appear in your CRM.
• Verify that updates from your portal also reach the external system when using two-way sync.

If you see problems, pause the test, adjust mappings or filters, and run the test again until the results are satisfactory.

How to Clear Test Sync Data in Hubspot

Once you finish evaluating your integration, you can remove test data created or updated during the test sync.

Use the Built-In Clear Test Data Option

1. Return to the app’s data sync settings.
2. Locate the section that refers to test sync or test data.
3. Select the option to Clear test data or similar wording.
4. Confirm that you want to delete or roll back the records affected during the test.

This cleanup ensures your portal remains accurate and avoids clutter from temporary records.

Switching from Test Sync to Live Sync

After your test runs are successful, you can safely move to a live configuration:

• Disable the test mode toggle in the integration.
• Double-check mappings and filters one last time.
• Turn on the full sync so all eligible records begin to flow between systems.
• Monitor the first hours of the live run to catch any remaining edge cases.

Taking these steps helps you transition smoothly from a controlled testing phase to a production-ready integration.

Additional Resources for Hubspot Integrations

You can find more detailed information about test sync behavior and options on the official documentation page: Set up a test sync.

If you need strategic help planning integrations, optimizing property structures, or aligning your CRM setup with broader marketing and sales operations, consider working with a specialized consulting team like Consultevo.

By using the test sync feature, preparing structured sample data, and carefully reviewing results, you can implement reliable integrations without putting your live CRM at risk.

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

“`