Gradient Works Docs
ProductDynamic BooksPricingRequest Demo
  • Welcome
  • ACCOUNT RESEARCH
    • Overview
      • Features
    • Market Map
      • Account Import
        • Salesforce
        • HubSpot
      • Salesforce Integration
        • How to Install Similar Accounts Component
      • CRM Export
        • Salesforce
        • HubSpot
      • FAQs
        • Attributes in Market Map
    • AI Researcher
      • How to create & configure an AI Researcher
      • Writing effective prompts
      • Prompt examples
      • Managed AI Researcher
    • Lookalikes
    • Credits
  • Bookbuilder
    • Overview
    • Enroll Accounts
    • Target Books
      • Target Book Report
      • Edit Reps
    • Account Coverage
      • Market Coverage
      • Rep Coverage
      • Working Activities
    • Transfer Accounts
      • Concepts
      • Account Pool
      • Distributions
      • Retrievals
      • Returns
      • Templates
      • Scheduling
      • Troubleshooting
    • How-to Guides
      • How to Rank Accounts for Distributions and Retrievals
      • How to Use the "Is In" Operator
  • Routing
    • Overview
    • Dashboard
    • Round Robin Queues
      • Create Queues
      • User Availability Status
      • User Working Hours
    • Users
    • Capacity Meters
    • Lead and Account Matching
    • Automation
      • Automation Executions
      • Log Entries
  • Automation Builder Kit (ABK)
    • Getting Started
    • Actions
      • Assignment
        • Directly Assign Items
        • Round Robin Assign Single Item
        • Round Robin Assign Multiple Items
        • Schedule and Assign Single Item
      • Dynamic Books
        • Retrieval
      • Flow Lifecycle
        • Execute Subflow
        • Failed
        • Finish
        • Resume
        • Start
      • Leads
        • Convert Lead
        • Convert Multiple Leads
      • Logs
        • Log Message
      • Matching
        • Match Account to Account
        • Match Lead to Account
        • Match Lead to Contact
        • Match Lead to Lead
      • Next Steps
        • Add Person to Campaign
        • Add Person to Sales Engagement Cadence
        • Check Person Enrollment in Cadence
        • Create Task
        • Send Single Assignment Email
        • Send Slack Message
      • Users
        • Get Used Capacity
        • Update Capacity
        • Update Weight
      • Utils
        • Evaluate Domain against Denylist
      • Advanced
        • Build Record Map from Lookup
        • Build Record Map from Field
        • Build Text Collection from Field
        • Convert ItemAssigned to Assignment
        • Execute SOQL
        • Get Record from Record Map
        • Assign Pending Items for Multiple Queues
        • Assign Pending Items for Single Queue
        • Enqueue Multiple Items
        • Enqueue Single Item
    • Models
      • AccountMatchResult
      • AccountToAccountMatch
      • Assignment
      • ConvertLeadRequest
      • ConvertLeadResult
      • DomainEvaluationResult
      • GenericSObject
      • LeadToAccountMatch
      • LeadToContactMatch
      • LeadToLeadMatch
      • QueueUserWeight
      • RecordMap
  • Integrations
    • Getting Started
    • Slack
    • Google Workspace
    • Microsoft 365
    • Salesloft
    • Outreach
  • Advanced
    • Salesforce Permissions
  • Miscellaneous
    • Changelog
Powered by GitBook
On this page
  • Required Data
  • Quick start: Import companies from a Hubspot List
  • Detailed Instructions
  • Import from CSV
  • Working with non-standard fields
  1. ACCOUNT RESEARCH
  2. Market Map
  3. Account Import

HubSpot

Get started with Market Map AI using company data from HubSpot.

Required Data

Market Map needs four key pieces of information from your Company records in HubSpot.

Company Field
Description

Record ID

Provides a unique identifier for each account. This allows you to later connect Market Map enrichment information like score and industry cluster to your CRM records

Company name

The name of the account. This is used in the Market Map Explorer to help you identify the account.

Company Domain Name

The website URL of the account. Market Map's AI engine will use this as a starting point for building an understanding about the products and services offered by this company.

Lifecycle Stage (typically)

Market Map uses accounts where this field = "Customer" to identify which accounts should be used in the customer lookalike scoring model. If customers are identified differently in your HubSpot, provide the field you use instead.

Quick start: Import companies from a Hubspot List

If you're familiar with HubSpot lists, see the quick instructions below. If you'd like a step-by-step explanation, view the detailed instructions.

  1. Create a new static Companies list with any filters you'd like to apply.

  2. Visit app.gradient.works and follow the steps to import from HubSpot.

    • You will select a List to import.

    • You will select the Target companies & weights to calculate the Market Map Score & Tier.

    • You will select the company properties to import to use in Map Explorer.

  3. Review the configuration and start the Market Map build.

  4. You'll receive an email when the Market Map is ready to access in app.gradient.works.

Detailed Instructions

How to create and import a list from HubSpot to Market Map.

Import from CSV

Alternatively, you can import companies from HubSpot by first exporting data to a CSV and then uploading the CSV in app.gradient.works.

How to create a HubSpot formatted CSV

The CSV must follow a specific format for import. See the example as a guide:

Select "CSV" under "File format". Make sure "Only properties in the view" is selected and that "Include all company domains" is unchecked. Click "Export".

After a moment, HubSpot will show you that the export is complete. If you don't see that notification, check your email.

Download the export from either the email HubSpot sends or the Notifications panel by clicking on the bell icon in the top right.

Working with non-standard fields

PreviousSalesforceNextSalesforce Integration

Last updated 7 months ago

Some HubSpot configurations do not use the built-in Lifecycle Stage field to identify companies as customers. If that's the case for you, please edit the exported CSV in Excel or Google Sheets and provide a field called Lifecycle Stage that contains the text "Customer" for each customer company. If you have any questions, please contact .

support@gradient.works
How-to tutorial for HubSpot
210B
mm--hubspot-company-export-example.csv
Example CSV File