Docs/HubSpot Setup Guide

Setup guide for RevenueKit.ai

RevenueKit.ai integrates your HubSpot portal with AI-powered analytics, CRM cleanup tools, and revenue intelligence. This guide walks through installing, configuring, using, and disconnecting the app.

With RevenueKit.ai, you can:

1. Install the app

RevenueKit.ai installs through HubSpot's official OAuth 2.0 flow. You'll need a HubSpot user with Super Admin or App Marketplace Install permissions for the portal you want to connect.

Step 1: Sign up for RevenueKit.ai

Go to app.revenuekit.ai and create an account by entering your email and choosing a plan. We support Google sign-in as well as email and password.

Screenshot placeholder

RevenueKit.ai signup / plan selection screen at app.revenuekit.ai

Step 2: Complete checkout

After creating your account, you'll be redirected to a secure Stripe checkout page to activate your Pro or Enterprise plan. Enter your billing details and complete the payment.

Screenshot placeholder

Stripe checkout page

Step 3: Connect your HubSpot account

After checkout, you'll see the HubSpot connection screen. Click Connect HubSpot. You'll be redirected to HubSpot to authorize the connection.

Screenshot placeholder

RevenueKit.ai 'Connect HubSpot' screen

Step 4: Choose your HubSpot account

If you have access to multiple HubSpot portals, HubSpot will ask you to choose which account to connect. Select the portal you want to use with RevenueKit.ai.

Screenshot placeholder

HubSpot 'Choose an Account' selection screen

Step 5: Approve the requested scopes

HubSpot will show the list of permissions RevenueKit.ai is requesting. Review the scopes and click Connect app to approve.

RevenueKit.ai requests the following scopes:

  • Read and write contacts, companies, and deals, including their properties
  • Read marketing emails, forms, lists, and automation workflows
  • Read and write CRM lists, for the Marketing Contacts sunset tool
  • Basic OAuth and content access, for authentication and integration health

Screenshot placeholder

HubSpot scope approval screen showing all requested scopes

Step 6: Confirm the connection

After approving, you'll be redirected back to RevenueKit.ai. Your dashboard populates with live HubSpot data within about 30 seconds.

Screenshot placeholder

RevenueKit.ai dashboard after successful connection

2. Configure the app

Once connected, RevenueKit.ai is ready to use with no additional configuration required. However, you can customize a few settings to match your workflow.

Configure the Executive Digest

Navigate to Executive Digest in the left sidebar. Choose your send day, recipients, and which sections to include. Click Save & Activate to schedule the weekly email.

Screenshot placeholder

Executive Digest configuration screen

Configure your plan and billing

Click the Settings gear icon in the top right. From here, you can view your current plan, update payment methods, and manage team members.

Screenshot placeholder

Settings > Billing screen

3. Use the app

RevenueKit.ai offers both manual tools (run on demand) and automated flows (run on a schedule). Here's how to use each:

Manual tools

Manual tools are run on demand from within RevenueKit.ai:

  • Property Health: Click Tools > Property Health, then click Scan to audit your HubSpot custom properties. Use the Bulk Updater to clean up inconsistent values.
  • Marketing Contacts: Click Tools > Marketing Contacts, then click Scan Marketing Contacts to identify sunset candidates. Preview lists and create them directly in HubSpot.
  • Duplicate Detection: Click Tools > Detect Duplicates to scan for duplicate contacts and companies.
  • UTM Builder: Click Tools > UTM Builder to build tracked campaign URLs and save them to your registry.
  • Visual Flow Builder: Click Tools > Create Visual Flow to build workflow diagrams.

Screenshot placeholder

Example: Property Health audit results

Automated flows

Automated flows run in the background on a schedule:

  • Executive Digest: Once activated, a weekly email is sent automatically to your chosen recipients at 6 AM in the scheduled day's time zone, summarizing HubSpot activity and strategic recommendations.
  • Dashboard refresh: Your Revenue and Growth dashboards automatically refresh with the latest HubSpot data on each visit.

Screenshot placeholder

Example: Executive Digest email preview

4. Disconnect the app

If you want to stop RevenueKit.ai from syncing with your HubSpot account without cancelling your subscription, you can disconnect the HubSpot connection from within the app.

  1. Click the Settings gear icon in the top right of RevenueKit.ai.
  2. Navigate to Integrations.
  3. Under the HubSpot connection, click Disconnect.
  4. Confirm the disconnection when prompted.

Screenshot placeholder

Settings > Integrations > Disconnect HubSpot button

Note

Disconnecting your HubSpot account immediately revokes RevenueKit.ai's access to your HubSpot data. Cached data within RevenueKit.ai is cleared on logout. Any automated flows, such as the Executive Digest, will pause until you reconnect. No changes are made to your HubSpot data itself, and lists or records created through RevenueKit.ai remain in HubSpot.

5. Uninstall the app

To fully uninstall RevenueKit.ai from your HubSpot portal, remove it from the Connected Apps list in your HubSpot settings.

  1. Log into your HubSpot portal.
  2. Click the Settings gear icon in the main navigation.
  3. In the left sidebar, go to Integrations > Connected Apps.
  4. Find RevenueKit.ai in the list of connected apps.
  5. Click Actions > Uninstall.
  6. Confirm the uninstallation.

For more details, refer to the HubSpot knowledge base article on managing connected apps.

Screenshot placeholder

HubSpot Settings > Integrations > Connected Apps > RevenueKit.ai > Actions > Uninstall

Note

Uninstalling RevenueKit.ai from HubSpot revokes all access tokens and permanently ends the integration. Your HubSpot data is not affected, and any lists, properties, or records created through RevenueKit.ai remain in HubSpot. To stop your RevenueKit.ai subscription and delete your account data, also cancel your plan in Settings > Billing within the RevenueKit.ai app.

Need help?

If you run into any issues with installation or setup, reach out to our team.

Contact support