---
title: "HubSpot Integration"
url: https://docs.mailbeast.ai/en/articles/56-hubspot-integration
collection: "Integrations"
updated: 2026-05-12
language: en
---

# HubSpot Integration

Connect MailBeast to your HubSpot CRM and run a clean two-way handoff between the two systems. Pull a HubSpot segment into a MailBeast campaign in one click, then push every converted lead back to HubSpot with full context.

* * *

## What the integration does

-   **Inbound** - pick any HubSpot list as the lead source for a campaign. Standard fields (email, name, company, job title, website) import automatically. Add up to **50 additional HubSpot properties** as custom variables you can use in your emails. Optional **recurring sync** keeps the campaign topped up as the list grows.
    
-   **Outbound** - when a lead in MailBeast reaches a positive status (**Interested reply**, **Meeting requested**, or **Converted**), MailBeast pushes the contact to HubSpot with campaign-source properties and adds a **Note** on the contact timeline with the reply context and a deep-link back to MailBeast.
    

* * *

## Prerequisites

-   A MailBeast organization on any active paid plan.
    
-   **Owner** or **Admin** role in the MailBeast organization.
    
-   A HubSpot account on any tier (Free works).
    
-   You must be signed in to HubSpot as a user with permission to install apps (Super Admin or App Marketplace Access).
    

* * *

## Step 1: Connect HubSpot

1.  In MailBeast, open [**Integrations**](https://app.mailbeast.ai/integrations) and click the **HubSpot** card.
    
2.  Click **Continue to HubSpot**.
    
3.  HubSpot opens its consent screen. MailBeast is not yet listed in the HubSpot Marketplace, so HubSpot shows an _unverified app_ warning and asks you to type **"I accept the risk"** to proceed. This is expected.
    
4.  Pick the HubSpot account you want to connect and click **Connect app**.
    
5.  HubSpot redirects you back to MailBeast. You should see a green **Active** badge on the integration page.
    

* * *

## Step 2: Import a HubSpot segment into a campaign

The HubSpot integration page is just the connection - the actual segment-to-campaign mapping lives inside each campaign's Leads tab.

1.  Open the campaign you want to populate (or [create a new one](https://docs.mailbeast.ai/en/articles/41.md)).
    
2.  Go to the **Leads** tab and click **Bulk Import**.
    
3.  Choose **Import from HubSpot**.
    
4.  Pick a HubSpot list.
    
5.  _(Optional)_ Pick additional HubSpot contact properties to bring across as custom variables. They become `{{custom_<property>}}` placeholders in your sequence editor.
    
6.  Click **Import**.
    

The import runs in the background. When it finishes, you'll see how many contacts came across and how many were skipped (no email, or already in the campaign).

* * *

## Step 3: Configure recurring sync (optional)

If you imported from an **active** HubSpot list - one whose membership changes over time - MailBeast can keep the campaign in sync automatically.

1.  Open [**Integrations** → **HubSpot**](https://app.mailbeast.ai/integrations/hubspot).
    
2.  In **Lead import recurring sync**, choose **Every 12 hours**, **Daily**, or **Off** (default).
    

Recurring sync pulls new members of the list into the campaign on schedule. Contacts already in the campaign are skipped - no duplicate sends.

* * *

## Step 4: Configure outbound triggers (optional)

By default, **Meeting requested** and **Converted** push to HubSpot. **Interested reply** is left off - it's positive but noisier - so we leave that choice to you.

1.  Open [**Integrations** → **HubSpot**](https://app.mailbeast.ai/integrations/hubspot).
    
2.  In **Push leads to HubSpot**, add or remove statuses from the multi-select.
    

Empty selection = outbound disabled entirely. Negative statuses (Not interested, Wrong person, Unsubscribed, Out of office) are never offered as triggers - by design, they don't belong in your CRM.

* * *

## Disconnecting

Open the integration page and click **Disconnect**. The integration is fully removed - recurring syncs stop, outbound pushes stop, OAuth tokens are deleted. Already-imported leads stay in your campaigns, and properties and Notes already written on HubSpot stay where they are. On reconnect you'll need to re-import each segment and pick a sync frequency again.

* * *

## Next Steps

-   [Create your first campaign](https://docs.mailbeast.ai/en/articles/41.md)
    
-   [Adding Leads to a Campaign](https://docs.mailbeast.ai/en/articles/42.md)
    
-   [Slack Webhook Integration](https://docs.mailbeast.ai/en/articles/25.md)
