HubSpot integration guide

Connect your HubSpot CRM portal to MyContentLab to track deal pipelines, closed revenue, contact acquisition velocity, and campaign-level sales attribution alongside your organic and paid social channels.

Overview and key benefits

Integrating HubSpot bridges the gap between top-of-funnel marketing (impressions, ad spend, video engagement) and bottom-of-funnel business outcomes:

• Revenue attribution: Connect closed-won HubSpot deals directly with specific marketing campaigns and social channels.
• Pipeline stage funnels: Visualize stage-by-stage deal progression, bottleneck stages, and conversion drop-offs.
• Win rate and sales velocity: Monitor average deal cycle times, deal values, and win/loss ratios in real time.
• Unified client reporting: Include live HubSpot sales KPIs in your executive PDF client reports and shareable portal dashboards.

┌───────────────────────────┐     ┌───────────────────────────┐     ┌───────────────────────────┐
│     TOP-OF-FUNNEL         │     │      MIDDLE-OF-FUNNEL     │     │      BOTTOM-OF-FUNNEL     │
│ Meta / TikTok / Ads / SEO │ ──> │  Content Lab & Engagement │ ──> │   HubSpot CRM Won Deals   │
│  Impressions & Clicks     │     │     Leads & Contacts      │     │  Revenue & Pipeline ROI   │
└───────────────────────────┘     └───────────────────────────┘     └───────────────────────────┘

Prerequisites

Before connecting HubSpot to a client workspace, ensure you have:

1. A MyContentLab account with an active client workspace.
2. User role permissions in MyContentLab: Owner, Manager, or Member with workspace access.
3. A HubSpot user account with Super Admin permissions or App Marketplace installation access for the target HubSpot Portal (Account ID).

What data gets synchronized

MyContentLab ingests CRM data using read-only API access on an automated schedule (every 2–4 hours):

1. Deals and pipeline stages

• Open pipeline value: Total monetary value of active deals currently in the sales pipeline.
• Closed-won revenue: Sum of all deals successfully closed in the selected period.
• Win rate (%): Percentage of total closed deals that resulted in a win: $$\text{Win Rate} = \frac{\text{Closed Won Deals}}{\text{Closed Won Deals} + \text{Closed Lost Deals}} \times 100$$
• Stage progression: Volume and monetary distribution of deals across custom pipeline stages (such as Lead, Discovery Call, Proposal Sent, Contract Sent, Won).

2. Contacts and lead generation

• Total and new contacts: Number of new contacts created in the period.
• Lifecycle stages: Ingestion of lifecycle status (Subscriber, Lead, MQL, SQL, Opportunity, Customer).
• Lead source: Ingested original source attribution (Organic Search, Paid Social, Direct Traffic, Referrals).

3. Sales activity and appointments

• Number of booked meetings and sales appointments linked to deals.

Step-by-step connection walkthrough

1. Open connections hub

1. In the left navigation, select the target Client Workspace.
2. Click Connections in the sidebar.
3. Locate the HubSpot integration card and click Connect.

Client Workspace > Connections > HubSpot Card > Click "Connect"

2. Authorize in HubSpot OAuth

1. A secure HubSpot OAuth authentication window will open.
2. If you manage multiple HubSpot accounts, select the specific HubSpot Portal / Account corresponding to this client.
3. Review the required read-only permissions:
   • crm.objects.deals.read - To read deal amounts, stages, and close dates.
   • crm.objects.contacts.read - To read contact creation dates and lifecycle stages.
   • crm.schemas.deals.read - To fetch custom pipeline names and stage configurations.
4. Click Choose Account and Connect App.

3. Configure pipeline and currency

1. Once redirected back to MyContentLab, the connection indicator changes to Connected (Green).
2. Select your client's Preferred Pipeline (e.g. Sales Pipeline, Enterprise Deals, or All Pipelines).
3. Verify the Currency Code (USD, EUR, GBP, AUD, etc.) matches your HubSpot portal settings.
4. Click Save Configuration.

NOTE

Initial synchronization typically takes between 30 to 90 seconds depending on the volume of historical deals in the HubSpot portal.

Exploring HubSpot data in MyContentLab

Once connected, navigate to Sales & CRM in the client sidebar to explore:

1. The CRM vital stat cards

• Open pipeline: Total active pipeline value in the selected date window.
• Deals won and revenue: Total revenue generated with period-over-period percentage growth.
• Win rate: Current close rate benchmarked against the previous period.
• New contacts: Net new customer records added to the database.

2. Pipeline funnel visualization

Interactive bar and area visualizations depicting how deals move across each stage of your sales funnel. Identify where prospect drop-offs occur to provide strategic advice to your client.

3. Top deals and lead attribution table

Inspect individual high-value deals:

• Deal name and company
• Monetary value
• Assigned sales representative
• Ingested marketing source tag (e.g. Meta Ad Campaign, Organic Video Hook, Google Search)

Security and privacy standards

• Read-only access: MyContentLab only reads deal and contact metrics. It never modifies, deletes, or overwrites records in your HubSpot CRM.
• Tenant isolation: Data synchronized for Client A is strictly isolated and can never be accessed or viewed by Client B.
• Encrypted credentials: OAuth access and refresh tokens are encrypted at rest using industry-standard AES-256 encryption.

Troubleshooting and FAQs

How often does HubSpot data refresh?

Data refreshes automatically every 2 to 4 hours. You can trigger an instant synchronization anytime by opening Sales & CRM and clicking Refresh Data.

What happens if our team creates a new pipeline in HubSpot?

Newly created pipelines in HubSpot are automatically detected during the next scheduled sync. To switch active views, open the pipeline selector dropdown at the top of the Sales & CRM page.

What should I do if the connection shows "Re-authentication Required"?

If an administrator changes passwords or revokes OAuth access in HubSpot settings:

1. Open Connections in MyContentLab.
2. Click Reconnect on the HubSpot card.
3. Complete the OAuth prompt to issue a fresh access token without losing historical report history.

Next steps

Related resources

• Sales & CRM feature guide - Deep dive into pipeline visualizations and lead attribution.
• Executive reports and PDF export - How to include CRM metrics in client presentations.
• Generic CRM connector - Connecting other sales CRM solutions.