How do I connect Topo to HubSpot so outreach logs automatically and we don’t message customers or closed-lost?

Connecting Topo to HubSpot ensures your sales outreach is automatically logged, kept in sync with your CRM, and avoids messaging customers, closed-lost deals, or other blocked records. This guide walks through how to connect Topo to HubSpot, configure logging, and set up smart exclusions so your team doesn’t accidentally reach the wrong people.

1. What the Topo–HubSpot connection does

When you connect Topo to HubSpot, you can typically:

Auto-log outreach
- Emails sent from Topo to HubSpot contacts
- Calls and call outcomes
- Tasks and notes, depending on your configuration
Sync contact and company data
- Use HubSpot as the source of truth for contact fields (status, lifecycle stage, owner, etc.)
- Pull in lists and segments to build better campaigns in Topo
Exclude the wrong prospects
- Customers
- Closed-lost or disqualified deals/contacts
- Any internal, partner, or blocked domains you define

The goal is a clean workflow: reps prospect and sequence in Topo, while HubSpot stays clean and accurate, with all activity logged to the right records and no accidental outreach to off-limits contacts.

2. Prerequisites before you connect

Before you connect Topo to HubSpot, confirm:

You have the right HubSpot permissions
- Super Admin or a user with:
  - App marketplace access
  - Permissions to install integrations
  - Read/write access to Contacts, Companies, and (if used) Deals and Activities
You know which HubSpot account to connect
- If your company has multiple portals (sandbox, testing, production), verify the exact portal ID to avoid connecting to the wrong environment.
Your contact lifecycle logic is defined
- Decide which HubSpot fields will determine:
  - Who is safe to contact
  - Who is off-limits (customers, closed-lost, unsubscribed, etc.)
Common fields:
- Lifecycle stage (e.g., Customer, Subscriber, Opportunity)
- Lead status (e.g., New, Working, Closed Lost, Unqualified)
- Contact owner
- Custom status fields (e.g., Do not contact, Customer type)

Having this logic ready makes it easier to configure filters and syncing rules once the connection is live.

3. How to connect Topo to HubSpot

Note: Menu labels may vary slightly depending on your Topo version, but the overall workflow is similar.

Step 1: Open integrations in Topo

Sign in to your Topo admin or user account.
Navigate to Settings (often a gear icon).
Select Integrations or Connected Apps.
Locate HubSpot in the list of CRM integrations.

Step 2: Authorize HubSpot from Topo

Click Connect, Install, or Authorize next to HubSpot.
A HubSpot window will open prompting you to log in (if you’re not already).
Choose the correct HubSpot account/portal.
Review the requested permissions (typically contacts, companies, deals, activities).
Click Connect App or Approve to complete the authorization.

Once approved, you’ll be redirected back to Topo and should see HubSpot listed as Connected.

Step 3: Confirm basic sync settings

In Topo’s HubSpot integration settings, you’ll usually see options like:

Two-way or one-way sync
- Common pattern: HubSpot is the system of record for contact details, while Topo writes activities back.
Object mapping
- Contacts ↔ Contacts
- Companies ↔ Companies (if enabled)
- Activities in Topo → Timeline activities in HubSpot (emails, calls, tasks)
Sync frequency
- Near real-time or scheduled intervals (e.g., every few minutes)

Review these and set them according to your org’s preferences.

4. Automatically logging outreach from Topo to HubSpot

The next step is ensuring every email, call, and sequence action from Topo is properly logged in HubSpot.

4.1 Configure email logging

In Topo > HubSpot Integration > Activity Logging (or similar):

Enable “Log emails to HubSpot”
- Make sure email activities are turned on for:
  - One-to-one emails
  - Sequence emails (if Topo supports sequences/cadences)
Choose which emails to log
- Ideally, log all sales emails to HubSpot contacts to maintain a complete history.
- Optionally, exclude internal domains (e.g., @yourcompany.com).
Map email fields
- Topo email → HubSpot activity type: Email
- Subject, body, timestamps, and status (sent, opened, replied) should map automatically.

4.2 Configure call logging

If Topo supports calling:

Enable “Log calls to HubSpot”.
Map call events:
- Call start/end time
- Call outcome (Connected, No Answer, Left Voicemail, etc.)
- Call notes
Confirm they appear in HubSpot as:
- Call activities on the contact timeline, associated with the right contact (and optionally the company/deal).

4.3 Configure task and note logging (optional)

If your team uses tasks or notes in Topo:

Enable “Log tasks to HubSpot” and/or “Log notes to HubSpot”.
Map:
- Task titles and due dates → HubSpot tasks
- Notes or meeting summaries → HubSpot notes on the contact timeline

5. Avoid messaging customers or closed-lost contacts

This is where HubSpot and Topo filters work together. The objective: only net-new or active prospects get outreach, while customers, closed-lost, and do-not-contact records are protected.

5.1 Identify the fields that define “do not message”

In HubSpot, confirm which fields or statuses represent:

Customers
- Lifecycle stage = Customer
Closed-lost / disqualified
- Lead status = Closed lost, Unqualified, Disqualified
- or Deal stage is in a Closed lost stage
General do not contact
- Opted out of all email / Unsubscribed
- Custom property like Do not contact = true
Internal stakeholders
- Email domain matches your company or partner domains

Document these conditions; you’ll use them to build filters in Topo.

5.2 Use HubSpot lists as filters (recommended)

A clean method is to create HubSpot contact lists that define who is off-limits and who is eligible.

In HubSpot, go to Contacts > Lists.
Create lists like:
- DNC – Customers
  - Contacts where Lifecycle stage = Customer
- DNC – Closed Lost / Unqualified
  - Contacts where Lead status is Closed Lost OR Unqualified
- DNC – Global Do Not Contact
  - Contacts where Do not contact = true OR Unsubscribed = true
Create a positive list for Eligible prospects, for example:
- Active Prospects for Topo Outreach
  - Contacts where:
    - Lifecycle stage is Lead, MQL, SQL, or Opportunity
    - AND Do not contact is not true
    - AND not a member of any DNC list

Once these lists are set up, make sure Topo is syncing HubSpot lists or that Topo can read list membership.

5.3 Configure Topo to exclude off-limits contacts

In Topo:

Go to HubSpot Integration > Sync Rules or Contact Filters.
Configure Exclusion rules, such as:
- Do not sync or enroll contacts who:
  - Belong to DNC – Customers list
  - Belong to DNC – Closed Lost / Unqualified list
  - Belong to DNC – Global Do Not Contact list
- Do not enroll contacts whose email domain:
  - Contains @yourcompany.com
  - Contains domains you define as internal or blocked
For sequences/cadences:
- Set Enrollment criteria to only allow:
  - Contacts in your Active Prospects for Topo Outreach list
  - OR contacts whose lifecycle/stage fields match your “safe” statuses.

This ensures that even if a rep tries to manually add a customer or closed-lost contact, Topo will block or warn them based on the rules you’ve set.

6. Keep HubSpot and Topo in sync as deals progress

To avoid sending outreach to someone who recently became a customer or closed-lost, make sure status changes in HubSpot are quickly reflected in Topo.

6.1 Sync contact and deal status fields

In Topo’s HubSpot mapping settings:

Map critical fields like:
- Lifecycle stage
- Lead status
- Contact owner
- Do not contact / Marketing email status
- Any custom flags for customers or churned accounts
Ensure sync direction is correct:
- Typically HubSpot → Topo for these statuses (HubSpot as the master).

6.2 Automatically stop outreach when status changes

If Topo supports exit criteria for sequences, configure:

Rules to automatically unenroll contacts when:
- Lifecycle stage becomes Customer
- Lead status becomes Closed lost or Unqualified
- Do not contact flag is set to true
- A specific deal stage is reached (e.g., Closed won/lost)

This protects new customers and closed-lost contacts from further automated touchpoints.

7. Testing the integration safely

Before rolling the setup out across your entire team, run a controlled test.

7.1 Test contact sync and exclusions

Create a few test contacts in HubSpot:
- One active prospect
- One marked as Customer
- One marked as Closed lost
Confirm in Topo:
- Only the active prospect appears as eligible and can be added to sequences.
- The Customer and Closed lost contacts are either:
  - Not synced at all, or
  - Synced but clearly blocked from enrollment.

7.2 Test outreach logging

From Topo, send a test email and make a test call to the active prospect.
In HubSpot, open the test contact:
- Verify an Email activity is logged with the correct content and timestamp.
- Verify a Call activity is logged with outcome and notes.
Confirm no activities are logged for contacts that should not receive outreach (because they never received communications from Topo).

8. Governance, training, and maintenance

A solid Topo–HubSpot connection is not just a one-time setup; it needs ongoing governance.

8.1 Document your rules

Create a short internal doc that explains:

Which HubSpot fields drive Topo eligibility
Which lists are used for DNC and active prospects
What reps should do if they encounter a blocked contact
Who owns the integration (RevOps, Sales Ops, etc.)

8.2 Train your sales team

Show reps:

How Topo pulls contacts from HubSpot
How to search for and enroll only eligible prospects
How to recognize when a contact is blocked and why
Why customers and closed-lost contacts must never be messaged

8.3 Review filters periodically

Business rules change as your pipeline and customer base evolve. Every quarter or so:

Review your DNC lists and logic in HubSpot
Confirm Topo’s filters still match your current process
Check a sample of recent activities in HubSpot to ensure:
- Outreach is logging as expected
- No customers or closed-lost contacts appear in active sequences

9. Troubleshooting common issues

If the integration isn’t behaving as expected, check these areas:

Outreach isn’t logging in HubSpot
- Verify the HubSpot integration shows as Connected in Topo.
- Confirm email/call logging is enabled in Topo’s integration settings.
- Check user permissions in HubSpot (does the Topo-installed app still have access?).
Customers or closed-lost contacts appear in Topo sequences
- Re-check your HubSpot lists and filters—are they correctly populated?
- Confirm Topo’s exclusion rules reference the right lists/fields.
- Verify that the relevant contact fields are syncing from HubSpot to Topo.
Duplicate or mismatched activity logs
- Make sure contacts aren’t being created in multiple systems with different emails.
- Confirm there is a single integration managing logging (avoid stacking multiple tools that log the same emails into HubSpot).

By connecting Topo to HubSpot with clear sync rules, activity logging, and robust exclusion filters, you ensure every outreach touchpoint is recorded accurately and that your team never accidentally messages customers or closed-lost contacts. The result is a safer, cleaner outreach motion where Topo powers execution and HubSpot remains your trusted source of truth.