HubSpot Integration

Overview

The Kustiq HubSpot integration connects your CRM to AI-powered company intelligence. It supports four core workflows:

• Import companies from HubSpot and profile them with AI.
• Sync up to 25 enriched properties back to HubSpot company records.
• Export outreach prospects as HubSpot companies and contacts.
• Monitor churn signals from HubSpot automatically (Pro plan, daily).

The integration is available on all plans (Free, Insight, and Pro). OAuth 2.0 handles authentication, and all long-running operations run as background jobs with progress tracking.

Prerequisites

• A Kustiq account (sign up here if you do not have one).
• A HubSpot account with access to the Companies and Contacts objects.
• Admin or super-admin permissions in your HubSpot portal (required to authorize the integration and create custom properties).

Step-by-step setup

1. 1

   Connect HubSpot

   In Kustiq, go to Integrations and click Connect HubSpot. You will be redirected to HubSpot to authorize Kustiq. Select the HubSpot portal you want to connect and approve the requested permissions.

2. 2

   Import companies

   Navigate to the Profiles page and click Import from HubSpot. Filter by industry, employee count, lifecycle stage, or search by name. Choose a profiling quality tier and start the import. See Importing companies for details.

3. 3

   Review profiles

   Once profiling completes, review the results on the Profiles page. Each company will show its segment, vertical, account tier, churn risk, growth signal, confidence score, and more.

4. 4

   Sync back to HubSpot

   Click Sync to HubSpot to push Kustiq intelligence back to your CRM. A custom property group called Kustiq Intelligence will be created with 25 company properties and 1 contact property.

5. 5

   Configure field sync

   Go to Integrations to choose which properties sync back to HubSpot. You can also rename each property label to match your team's naming conventions. See Field configuration for details.

6. 6

   Use the data in HubSpot

   Once synced, Kustiq properties appear on every profiled company record. You can use them to:

   • Build smart lists filtered by churn risk or segment.
   • Trigger workflows based on growth signals or account tier.
   • Create reports segmented by vertical, ICP tier, or sales priority.
   • Prioritize accounts for sales and CS teams using fit scores.

   Quick verification: after your first sync, open any profiled company in HubSpot and scroll to the “Kustiq Intelligence” property group. You should see fields like Segment, Vertical, and Churn Risk populated. If the group doesn’t appear, check your field sync settings in Integrations.

Importing companies

When importing from HubSpot, you can filter which companies to profile:

• Search: free-text search by company name.
• Industry: filter by HubSpot industry field.
• Employee count: set minimum and maximum employee range.
• Lifecycle stage: filter by HubSpot lifecycle stage.
• Domain required: enabled by default. Companies without a domain cannot be profiled and are excluded.

Each import batch can include up to 200 companies. Choose a profiling quality tier:

• Economy (0.33 credits per company): faster, lighter analysis.
• Standard (1 credit per company): balanced depth and speed.
• Premium (2 credits per company): deepest analysis with full signal extraction.

Credits are deducted atomically at the start of the import. The profiling runs as a background job, and results are automatically synced back to HubSpot when complete. Companies already profiled in Kustiq are excluded from the import list.

Syncing profiles back

After profiling, you can sync Kustiq intelligence back to HubSpot. There are two ways to trigger a sync:

• Automatic (on import): when you import companies from HubSpot, Kustiq automatically syncs enriched profiles back after profiling completes.
• Manual: select profiles on the Profiles page and click Sync to HubSpot. You can sync up to 2,000 profiles at a time.

During sync, Kustiq searches for the matching HubSpot company by domain. If a match is found, it updates the existing record. If no match exists, Kustiq creates a new company in HubSpot. The sync respects your field configuration, only writing enabled fields.

If outreach prospect data exists for a company, it is merged with the profile data during sync. Profile data takes precedence when both sources have values for the same field.

Field configuration

Go to Integrations to configure which properties sync back to HubSpot.

Selective field sync

Toggle individual fields on or off. Only enabled fields are written to HubSpot during sync. By default, all fields are enabled. Use the select/deselect all toggle at the top for bulk changes. When all fields are enabled, Kustiq stores this as “all fields” internally, so any new properties added in future updates are automatically included.

Custom labels

Each property has a default label (e.g., “Kustiq Segment”). You can rename any label to match your team’s naming conventions. When you save, Kustiq updates the property labels in HubSpot so your team sees the custom names in the CRM.

Exporting outreach prospects

From the Outreach page, select prospects and click Sync to HubSpot. You can export up to 2,000 prospects at a time.

For each prospect, Kustiq:

1. Searches HubSpot for an existing company matching the prospect’s domain.
2. If found, updates the existing company with Kustiq properties (ICP tier, score, sales priority, outreach hooks, and more).
3. If not found, creates a new HubSpot company from the prospect data, including industry (mapped to HubSpot’s industry enum), employee count, and all Kustiq intelligence fields.
4. If the prospect has a contact email, creates a HubSpot contact with name, email, job title, and phone, then associates the contact with the company.

The contact property Email Confidence is set on created contacts to indicate the verification confidence level.

If a contact with the same email already exists in HubSpot, the contact creation is skipped to avoid duplicates. The company record is still updated.

Automated churn monitoringPro plan

For Pro plan customers with HubSpot connected, Kustiq runs a daily automated sync (5:30 AM UTC) that fetches engagement signals from HubSpot and uses them to run churn prediction scoring.

Signals fetched from HubSpot for each profiled company:

• Deal count: whether deals exist, single vs. multi-thread engagement.
• Contact count: single-threaded (1 contact) vs. multi-threaded relationships.
• Record age: how long the company has been in your HubSpot (new vs. established).
• Contact activity recency: last activity date across associated contacts (disengaged vs. active).

When a company’s churn prediction score transitions upward to high or critical, Kustiq triggers an alert and fires a webhook (if configured). This gives your CS team early warning before accounts churn.

Property reference

Kustiq creates a Kustiq Intelligence property group on both Companies and Contacts objects.

Company properties (25 fields)

Contact properties (1 field)

• Email Confidence (kustiq_email_confidence) (text): verification confidence level for the contact email

Permissions requested

When you connect HubSpot, Kustiq requests six OAuth scopes:

In plain terms: Kustiq can read and write to your Companies and Contacts. It cannot access deals, tickets, emails, or anything else in your HubSpot portal.

• crm.objects.companies.read: import companies into Kustiq for profiling.
• crm.objects.companies.write: sync intelligence back to company records and create new companies from outreach prospects.
• crm.schemas.companies.read: read existing property schemas before creating custom properties.
• crm.schemas.companies.write: create the Kustiq Intelligence custom property group and its 25 properties.
• crm.objects.contacts.read: import contacts, read contact activity for churn signal monitoring.
• crm.objects.contacts.write: create contacts discovered through the outreach pipeline and set the email confidence property.

Kustiq does not access deals, tickets, or any other HubSpot objects.

Background jobs

All long-running HubSpot operations (import, sync, export) run as background jobs. You can track progress on the Profiles or Outreach pages.

Concurrent job limits

The number of simultaneous background jobs depends on your plan:

• Free: 1 concurrent job
• Insight: 3 concurrent jobs
• Pro: 10 concurrent jobs

Batch limits

• Import: up to 200 companies per batch
• Sync: up to 2,000 profiles per batch
• Export: up to 2,000 prospects per batch

Webhooks

Kustiq can send webhook notifications for key events. Configure your webhook URL in Integrations.

Supported events

• profile.created: fired when a new company profile is generated.
• churn.score_changed: fired when a churn prediction score changes.
• churn.alert_created: fired when a churn alert is triggered.
• outreach.job_completed: fired when an outreach pipeline job finishes.

Security and retries

Webhook payloads are signed with HMAC-SHA256 so you can verify authenticity. Failed deliveries are retried once after 5 seconds.

Data handling

Data flow

• Imported from HubSpot: company name, domain, industry, employee count, lifecycle stage, revenue, description, and associated contacts.
• Synced to HubSpot: up to 25 company properties and 1 contact property (configurable via field sync settings).

Token security

• Your OAuth tokens are encrypted at rest (AES-256 via Supabase). We never share them with third parties.
• Token refresh is handled automatically. If a token expires, Kustiq silently refreshes it using the stored refresh token.

To request deletion of all HubSpot-sourced data stored in Kustiq, email support@kustiq.com. We will remove the data within 30 days per our Data Processing Agreement.

For full details, see our Privacy Policy, Terms of Service, DPA, and Trust & Security page.

Disconnecting

To remove the integration, go to Integrations in Kustiq and click Disconnect HubSpot. This immediately revokes access and clears stored tokens. The Kustiq Intelligence property group and its values will remain in HubSpot until you manually delete them.

Troubleshooting

• Authorization fails: make sure you have admin or super-admin permissions in your HubSpot portal.
• Companies not importing: ensure your HubSpot companies have a domain set. Companies without a domain cannot be profiled and are excluded by default.
• Sync errors: if sync-back fails, try disconnecting and reconnecting. This forces a fresh token exchange. If the issue persists, contact support@kustiq.com.
• Properties not appearing: check your field sync settings in Integrations. Disabled fields are not written to HubSpot. Also verify that the Kustiq Intelligence property group exists on the Companies object in HubSpot Settings.
• Custom labels not updating: label changes are pushed to HubSpot in the background. Allow a few seconds and refresh the HubSpot company record.
• Churn signals not updating: automated churn monitoring is only available on the Pro plan. The sync runs daily at 5:30 AM UTC. Check that your HubSpot connection is still active.
• Concurrent job limit reached: wait for an existing job to complete, or upgrade your plan for higher limits.
• Prospect export not creating contacts: contacts are only created when the prospect has an email address. Prospects without email are exported as companies only.
• Token refresh failed: if HubSpot shows as disconnected unexpectedly, the refresh token may have been revoked from HubSpot’s side. Go to Integrations and reconnect.
• Some companies missing from import list: companies already profiled in Kustiq are automatically excluded. Check the Profiles page.
• Property group deleted from HubSpot: if someone deletes the Kustiq Intelligence property group in HubSpot, the next sync will recreate it automatically.
• Job failed mid-batch: partially processed companies are saved. Unused credits are returned to your balance. Check job status on the Profiles page.