Zuppa Sync
Attio and HubSpot integration
Documentation
User guide for setting up and running Zuppa Sync
This guide explains how to use Zuppa Sync to connect Attio and HubSpot, configure synchronization, monitor activity, and keep your setup healthy.
Best first path
Create one mapping, one profile, then review logs.
Quick Start
Follow these steps when setting up Zuppa Sync for the first time.
Step 1
Create your account
Sign up, confirm access, and open the dashboard. The dashboard is where you create and manage all sync setups.
Step 2
Create a mapping
A mapping is the workspace for one Attio and HubSpot sync setup. Give it a clear name, choose the sync direction, and select the plan that fits your expected usage.
Step 3
Confirm plan or free tier
Some deployments use a free tier and activate the mapping immediately. If checkout is shown, complete the hosted checkout flow before continuing setup.
Step 4
Connect Attio and HubSpot
Open the mapping and connect both provider accounts. Use accounts that have permission to read and update the records you want to synchronize.
Step 5
Create your first sync profile
Choose the Attio object, the HubSpot object, and the fields that identify matching records. Then add the properties you want to keep aligned.
Step 6
Review activity
Use the Statistics and Logs tabs to confirm that records are being processed and to spot any records that need attention.
Core Concepts
These are the main product terms you will see while using the app.
Mapping
A mapping is a separate sync workspace. It owns its connected accounts, members, profiles, plan, statistics, and logs.
Sync direction
Direction controls where updates can flow: HubSpot to Attio, Attio to HubSpot, or both directions.
Sync profile
A profile tells Zuppa Sync which Attio object should sync with which HubSpot object, and which fields should be used.
Matching fields
Matching fields are used to find the same record in both systems. Common examples are email, company domain, or an external ID.
Property mappings
Property mappings define which individual values should be copied between systems after a matching record is found.
Hourly limit
Each plan has an hourly processing limit. When the limit is reached, extra records may be skipped until capacity is available again.
Daily Use Recommendations
A clean setup is easier to monitor and safer to change over time.
Keep mapping names specific, such as North America Contacts or Enterprise Companies.
Use stable matching fields that do not change often.
Start with a small set of important properties, then add more after confirming the sync behaves as expected.
Check the Logs tab after changing a profile or connecting a new account.
Pause profiles that should temporarily stop syncing instead of deleting them.
Invite teammates only when they need access to configure or monitor a mapping.
Troubleshooting
Use these checks when something does not behave as expected.
A mapping says payment is required
Complete checkout or resolve the billing issue before continuing setup or running sync. Free-tier mappings should not show this state.
Provider fields do not appear
Confirm that the connected Attio or HubSpot account has access to the selected object and fields. Reconnect the provider if permissions recently changed.
Records are not matching
Review the matching fields. The value must be present and comparable in both systems, such as the same email address or domain.
Some records are ignored
Open Statistics and Logs to see the reason. Common causes include plan limits, missing required values, inactive profiles, or disconnected provider accounts.
A profile should stop syncing
Pause the profile from the mapping page. Pausing keeps the configuration available for later use.
A provider connection needs attention
Reconnect the affected provider from the mapping page, then review the latest logs after synchronization resumes.
When in doubt
Start small: connect the accounts, create one profile, sync a limited set of fields, review the logs, and expand the configuration after the results are clear.