HappyStack  /  Integrations  /  HubSpot

HubSpot setup guide

Connect HubSpot to HappyStack so your customers, open pipeline and opted-out contacts are never contacted, and every email HappyStack sends is logged as a HubSpot activity on the right contact.

About 10 minutes  ·  Needs a HubSpot Super Admin  ·  Last updated 17 November 2026

When to use this guide: use it when you're connecting HubSpot to HappyStack for the first time, or reconnecting after a disconnect.

This guide has three main steps:

  1. Create your do-not-contact segments (lists) in HubSpot.
    Decide who HappyStack should never contact.
  2. Connect HubSpot to HappyStack.
    Sign in to HubSpot and approve access.
  3. Map your segments in HappyStack.
    Tell HappyStack which segment is which.

If you'd like us to walk you through it, contact your HappyStack account manager and we'll set it up with you on a call.

Before you start

You'll need:

  • A HappyStack account. You'll connect from app.happystack.com.
  • A HubSpot user with permission to install apps. In most portals that means a Super Admin.
  • The HubSpot portal you want to connect. If you have more than one, HubSpot asks you to choose during setup.

Step 1: Create your do-not-contact segments (lists) in HubSpot

HappyStack doesn't recreate your filters. It reads the members of segments (lists) you already manage in HubSpot, so you stay in control: change a segment's filters and what HappyStack excludes changes with it.

HubSpot now calls lists segments. You'll find them under CRM › Segments. HappyStack's own screens still say "lists", so the two words mean the same thing in this guide.

In HubSpot, create one segment (list) for each of the categories below. Set each one to update automatically (an active segment), so new customers or opt-outs are picked up without you doing anything.

Segment (list)TypeWho goes in it
In pipelineCompaniesCompanies your team is actively working
DisqualifiedCompaniesCompanies your team has disqualified for any reason
Closed lostCompaniesCompanies marked closed lost or gone cold
Current customersCompaniesYour current customers
Former customersCompaniesCustomers who have churned
Opt out / unsubscribeContactsAnyone who has asked not to be contacted by your team
OtherEitherAnyone else you want excluded

How matching works: company segments are matched on company domain, and contact segments are matched on email address. You don't need every category. Create the ones that apply to you.

Step 2: Connect HubSpot to HappyStack

  1. In HappyStack, go to Settings › Integrations › HubSpot (or open app.happystack.com/settings/integrations/hubspot) and click Connect HubSpot.

    HubSpot settings page in HappyStack with the Connect HubSpot button highlighted
    The HubSpot page in HappyStack before you connect.
  2. HubSpot opens. Click Sign in to your HubSpot account and sign in as a user who can install apps.

    HubSpot screen titled Connecting your HappyStack account to HubSpot with sign-in options
  3. Choose the HubSpot portal you want to connect and click Choose Account.

    HubSpot Choose an account screen with one portal selected
  4. Review what HappyStack can access and click Connect app. Each permission is explained in What HappyStack can access below.

    HubSpot permissions screen listing the eight access requests for HappyStack, with Connect app button
  5. If HubSpot shows a Connecting an unverified app warning, type I accept the risk and click Connect.

    HubSpot Connecting an unverified app dialog with I accept the risk typed in the confirmation box

    Why you might see this: HubSpot shows this notice for apps that haven't finished its marketplace review. It's expected while HappyStack's review completes, and it goes away once the app is approved. Check that the redirect domain shown is app.happystack.com.

  6. You'll land back in HappyStack. The HubSpot page now shows Connected and healthy.

Step 3: Map your segments in HappyStack

Now tell HappyStack which HubSpot segments (lists) to exclude.

  1. On the HubSpot page in HappyStack, scroll to Do-not-contact lists. If you've just created your segments, click Refresh lists.

  2. Add a segment, then choose the Reason that matches it: In pipeline, Disqualified, Closed Lost, Customer, Former Customer, Opt out / Unsub or Other.

    Classify HubSpot list dialog in HappyStack showing the reason options
  3. Click Add list. Repeat for each segment you created. Changes save automatically.

Good to know: the reason is for your own organisation. Every segment you add is excluded in the same way, whatever reason you give it.

What HappyStack can access

HubSpot asks you to approve these permissions when you connect. Here's what each one is for.

ObjectAccessWhat HappyStack does with it
CompaniesReadReads company names and domains to match companies on your do-not-contact segments (lists).
CompaniesWriteCreates the company when HappyStack contacts someone at a company that isn't in your CRM yet. Never deletes companies or changes deal stages, lifecycle stages or existing properties.
ContactsReadReads email addresses to match your opt-out and do-not-contact segments (lists).
ContactsWriteCreates a HubSpot activity record on the matching contact for each email HappyStack sends, and creates the contact if they aren't in your CRM yet. Never deletes contacts.
Segments (lists)ReadReads membership of the specific segments you choose, nothing else.
DealsReadReads deal stage and status to report on leads HappyStack sourced, such as meeting booked or won.
AccountReadReads your portal's primary domain and the connecting user's email to confirm which portal is connected.
One-to-one emailsReadSees outreach your team has already sent, so HappyStack doesn't contact someone you're already talking to.

What HappyStack never does

  • Delete contacts, companies or any other record.
  • Create deals, change deal stages, assign owners or route leads.
  • Change lifecycle stages or overwrite existing properties.

How duplicates are avoided

Before creating a record, HappyStack checks for an existing one. Contacts are matched by email address. Companies are matched by domain, including the alternative domains HappyStack keeps on file, so an existing company is found rather than a new one created.

How often data syncs

The first sync reads your full company and contact base. After that, HappyStack only fetches records that have changed since the last sync, usually once every 24 hours, and picks up association changes as they happen. API usage stays well within HubSpot's daily limits.

How to disconnect

  1. In HappyStack, go to Settings › Integrations › HubSpot.

  2. Click Disconnect.

    HubSpot page in HappyStack showing Connected and healthy, with the Disconnect button highlighted

This removes the HappyStack app from your HubSpot portal and revokes all access. HappyStack stops reading your data immediately.

FAQ

Does HappyStack get access to my whole CRM?

HappyStack can read your full contact and company base, which it needs to recognise who to exclude. Most of the people on your do-not-contact segments won't be prospects HappyStack sourced, so it has to see them to avoid contacting them.

Which fields can HappyStack see?

HubSpot grants read access to all fields on the objects listed above. HappyStack uses the ones described in What HappyStack can access, such as company domain and contact email.

Where does HappyStack's outreach show up in HubSpot?

Each email HappyStack sends is created as an activity record on the matching contact in HubSpot, so your team can see what a prospect was sent before they pick up the conversation.

Will this change how leads are created or assigned?

No. HappyStack doesn't create deals, assign owners or route leads, so your existing lead generation and assignment process stays the same.

Who needs to connect HubSpot?

Someone with permission to install apps in your HubSpot portal, usually a Super Admin. You only need to connect once per HappyStack workspace.

What happens if I change a segment (list) in HubSpot?

HappyStack picks up the new membership on its next sync. If you create a new segment, click Refresh lists on the HubSpot page in HappyStack and add it.

Need a hand?

Contact your HappyStack account manager, or email support@happystack.com and we'll help you get connected.

Contact support