HubSpot integration
Last updated: November 10, 2026
Connect HubSpot to CRED to bring your HubSpot companies, contacts and deals into CRED and write changes back. This article covers what's specific to HubSpot. For how sync works in general, see the CRM integrations overview.
What CRED syncs
HubSpot object | In CRED | CRED can write back |
|---|---|---|
Companies | Account | Yes |
Contacts | Contact | Yes |
Deals | Opportunity | Yes |
Deal pipelines | Opportunity pipeline | No |
Deal stages | Opportunity stage | No |
Line items | Opportunity product | Yes |
Emails (one-to-one sales emails) | Read into CRED | |
Custom objects | Custom object records | Yes |
Users | CRM user (for owners) | No |
Marketing campaigns | Campaign | No (read only; may not be enabled for your workspace yet) |
Custom properties on companies, contacts and deals are found automatically and can be mapped in the wizard.
Notes, tasks and calls aren't synced. HubSpot doesn't offer an app permission that lets CRED read them.
Emails and line items need permissions that were added after some connections were made. If they don't appear, reconnect HubSpot to grant them.
Before you connect
Connect with a HubSpot user who can see and edit every object you plan to sync. CRED can see and edit what that user can.
Use a dedicated integration user rather than a person's own login, so the connection doesn't depend on one employee.
How to connect HubSpot
Open Integrations in the left navigation and find HubSpot under CRM & Sales.
Click Connect (or Enable) on the tile and continue to HubSpot.
Sign in, pick your HubSpot account, and approve the permissions CRED asks for. They cover reading and writing companies, contacts, deals, line items and custom objects; reading their schemas, users and one-to-one emails; and, if your HubSpot account has Marketing Hub, reading marketing campaigns.
Back in CRED, the integration wizard opens. Choose Automatic or Custom setup, pick the objects to sync, map fields and set write rules. See the overview for each step.
To change settings later, click Settings on the HubSpot tile. To disconnect, click Disconnect on the tile. Disconnecting stops syncing; records already in CRED and HubSpot stay where they are.
How HubSpot sync works
First read: CRED reads each object you chose, in order (users, pipelines and stages first, then companies and contacts, then deals). Large portals can take several hours.
Ongoing reads: about once an hour, CRED reads the records whose last-modified date changed since the last sync.
On demand: Pull latest from HubSpot on a company or person's sidebar re-reads that record now. Pull all changes since last sync in the connection's settings panel reads every recent change.
Real-time sync (new & deleted records): new and deleted HubSpot records reach CRED within seconds; edits still sync on the regular schedule. This may not be enabled for your workspace yet; contact support to turn it on. If the toggle asks you to reconnect, HubSpot needs to grant extra permissions first.
Deleted records: CRED checks for companies, contacts, deals and other records deleted in HubSpot in the last 29 days and removes them from CRED. Pipelines, stages and users are kept up to date by the regular reads.
Writing back: depends on each object's Update Rule and Create Rule and each field's write rule. See the overview.
API usage
HubSpot limits how many API calls an app can make. CRED stays at or below 140 requests every 10 seconds and retries automatically if HubSpot asks it to slow down. Portals on HubSpot's lower tiers have lower limits, so large first reads take longer there.
Troubleshooting
HubSpot error | What it means | What to do |
|---|---|---|
| The HubSpot property was deleted or renamed. | Update the mapping in the wizard. |
| The value isn't one of the dropdown's options in HubSpot. Option values must match exactly, including case. | Add the option in HubSpot, or change the value in CRED. |
| HubSpot manages this property and won't accept writes. | Set the field's write rule to Never, or unmap it. |
| Usually a type mismatch, for example text into a number field, or a badly formatted date. | Check the value and the field type, then sync again. |
| CRED doesn't have HubSpot permission for this object. | Reconnect HubSpot and approve all permissions. |
| Your portal hit HubSpot's API limit. | CRED retries automatically. If it keeps happening, check other apps using your portal's API. |
The tile says Relink Needed. HubSpot revoked or expired CRED's access. Click Relink and sign in again. No data is lost.
Duplicates in HubSpot. Set the Create Rule to Manual or Off, and review matches on the Matching page.
For record-level errors and missing required fields, see Fixing CRM sync issues. When you contact support@credplatform.com, include the record name, the field, and the error from Data Sync Log or Sync Health.