Comment on page


Get started with Market Map AI using company data from HubSpot.
Gradient Works securely processes and stores all Market Map data. As an added layer of security, we do not connect directly to HubSpot. Instead we rely on you to upload your data through our secure form. Please only provide only the information requested.

Quick start

If you're familiar with HubSpot views and exports, see the quick instructions below. If you'd like a step-by-step explanation, view the detailed instructions.
  1. 1.
    Create a new Company view with any filters you'd like to apply
  2. 2.
    Edit columns, including only the following: Company name, Company Domain Name and Lifecycle Stage (Record ID will be automatically included in the export)
  3. 3.
    Export the view, ensuring the "File format" is "CSV" and "Only properties in the view" is selected.
  4. 4.
    Download the CSV from your notifications panel or the email that Hubspot sends on export completion
  5. 5.
    Upload the CSV to Gradient Works

Example CSV

Use this example CSV file as a guide to make sure yours looks correct. You can view it in Excel, Google Sheets or a text editor.
Example CSV File

Data description

Market Map needs four key pieces of information from your Account records.
Company Field
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.

Detailed export instructions

First, go to Contacts -> Companies and click "Add view".
Creating a new Companies view
Provide a name for the view and select your sharing visibility. (Select "Private" if you don't want to share with others.) Click "Confirm".
You will be taken back to the basic view. Adjust your filters to show only the companies you want to include. Then click "Edit columns".
Editing columns
Make sure only Company name, Company Domain Name and Lifecycle Stage are under "SELECTED COLUMNS". Click "Apply". Your view will look similar to the below.
Viewing the view
Click "Export" in the top right.
Exporting the view
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.
Upload the CSV to Gradient Works.

Working with non-standard fields

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 [email protected].