How to Connect HubSpot to Skopx: Complete Integration Guide

Connecting HubSpot to Skopx enables AI-powered marketing analytics, deal tracking, and contact intelligence through natural language queries. This guide walks through the setup, available data, and practical applications for the integration.

Prerequisites

Before connecting HubSpot:

• A Skopx account (free tier or above)
• A HubSpot account (Free, Starter, Professional, or Enterprise)
• Admin or super admin permissions in your HubSpot portal
• Your AI API key configured in Skopx settings

Step-by-Step Setup

Step 1: Open Integrations

Log in to Skopx and navigate to the Integrations tab.

Step 2: Locate HubSpot

Search for "HubSpot" or browse the CRM category. Click the HubSpot card.

Step 3: Authorize the Connection

Click "Connect HubSpot." You will be redirected to HubSpot's OAuth authorization page. If you have access to multiple HubSpot portals, select the one you want to connect.

Permissions requested include:

• CRM access. Read contacts, companies, deals, and tickets.
• Marketing access. Read campaigns, emails, forms, and landing pages.
• Sales access. Read deals, pipeline, and activities.

Click "Connect app" to authorize.

Step 4: Configure Data Scope

After authorization, Skopx shows the HubSpot objects available for analysis. Select which objects to include. Most organizations start with Contacts, Companies, Deals, and Marketing Emails.

Step 5: Verify

Ask "How many contacts are in our HubSpot database?" to confirm the connection is working.

Available Data

Practical Use Cases

Marketing Performance

Analyze campaign effectiveness across all marketing channels.

Example queries:

• "What is the open rate for our email campaigns this month?"
• "Which landing page has the highest conversion rate?"
• "Show me form submissions by source for the last 30 days"
• "Compare email click-through rates across our last 5 campaigns"
• "How many marketing qualified leads did we generate this quarter?"

Deal Pipeline

Track deals and forecast revenue without manual report building.

Example queries:

• "Show me the deal pipeline by stage"
• "What is the total value of deals expected to close this month?"
• "Which deals have not had any activity in the last 14 days?"
• "What is our average deal size in the Professional pipeline?"
• "Compare win rates between the SMB and Enterprise pipelines"

Contact Intelligence

Understand your contact database and engagement patterns.

Example queries:

• "How many contacts moved to SQL status this month?"
• "Show me the lifecycle stage distribution of our contacts"
• "Which lead source generates the most contacts?"
• "List contacts who opened our last 3 emails but have not converted"
• "What is the average time from MQL to SQL?"

Sales Activity Tracking

Monitor rep activities and productivity.

Example queries:

• "How many meetings did the sales team log this week?"
• "Show me sales activities by type for each rep"
• "Which reps have completed the most sequence enrollments?"
• "What is the average response time to new leads by rep?"

Support Analytics (Service Hub)

Track support ticket performance and customer satisfaction.

Example queries:

• "What is our average ticket resolution time?"
• "Show me open tickets by priority"
• "Which ticket category has the most volume?"
• "What is our customer satisfaction score trend over the last quarter?"

Security and Privacy

OAuth 2.0 Protocol

HubSpot connection uses OAuth 2.0 with scoped permissions. Skopx requests only the permissions needed for read access.

Read-Only Operations

Skopx performs read-only queries against HubSpot's API. No records are created, modified, or deleted through the integration.

No Data Storage

HubSpot data is queried in real time. Skopx does not maintain a local copy of your contacts, deals, or marketing data.

BYOK Processing

AI analysis of your HubSpot data uses your own API key, keeping your CRM data within the data flow you control.

Revoking Access

Disconnect from the Skopx integrations page. In HubSpot, go to Settings, then Integrations, then Connected Apps, and remove the Skopx connection.

Troubleshooting

"Insufficient scopes" error

This occurs when the required API scopes were not granted during authorization. Disconnect and reconnect the integration, ensuring all requested scopes are approved.

API rate limiting

HubSpot enforces API rate limits based on your subscription tier. Free and Starter plans have lower limits. If you experience rate limiting, reduce the frequency of broad queries and use filters to narrow your data requests.

Marketing data not available

Marketing Hub data requires a Marketing Hub subscription (Starter or above). If you are on the free CRM, marketing analytics endpoints will not return data.

Custom properties not appearing

Custom properties are accessible but must be referenced by their internal name, which may differ from the display name. Check HubSpot's property settings for the internal name.

Advanced Configuration

Cross-Platform Marketing Intelligence

HubSpot is most powerful when connected alongside other tools in Skopx:

• HubSpot plus Gmail: "Show me email threads with contacts in the Opportunity stage"
• HubSpot plus Google Calendar: "How many meetings this week are with contacts from HubSpot?"
• HubSpot plus Slack: "Find Slack discussions about deals that are closing this month"
• HubSpot plus Stripe: "Match deal amounts with actual payment data from Stripe"

These cross-platform queries give your go-to-market team a unified view of the customer journey, from first marketing touch through deal close and payment.

Next Steps

With HubSpot connected, your marketing and sales teams have conversational access to CRM analytics. Add Gmail and Slack for complete communication analytics, or connect Stripe to track revenue alongside deal data.