{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Integrations","type":"markdown"},"seo":{"title":"Hubspot Import Integration","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"hubspot-import-integration","__idx":0},"children":["Hubspot Import Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/int/hubspot-export-integration"},"children":["Learn more about HubSpot Export Integration"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HubSpot is an inbound marketing and sales platform that helps companies attract visitors, convert leads, and close deals. Using this integration to import HubSpot data in TD to eliminate the data silos, understand the customer behavior across all touchpoints, and create more relevant and timely interactions with customers, leading to better retention and loyalty."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Various HubSpot objects are supported in this integration, including Contacts, Companies, Contact Lists, Email events, Engagement activities, Deals, and other data objects."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Basic knowledge of Treasure Data"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Basic knowledge of HubSpot"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"static-ip-address-of-treasure-data-integration","__idx":2},"children":["Static IP Address of Treasure Data Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your security policy requires IP whitelisting, you must add Treasure Data's IP addresses to your allowlist to ensure a successful connection."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Please find the complete list of static IP addresses, organized by region, at the following ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/endpoints/ip-addresses-integrations-result-workers"},"children":["document"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-new-authentication-on-the-treasure-console","__idx":3},"children":["Create a New Authentication on the Treasure Console"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you configure a data connection, you provide authentication to access the integration. In Treasure Data, you configure the authentication and specify the source information."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations Hub"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Catalog"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Search for and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HubSpot"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-import-integration-2024-12-11.5bde931f7b4dbd26258a20ac4ebc17dc0b7f7c929d1e1221e17940894872e103.899d1e34.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Authentication"]}," and provide the OAuth of a HubSpot account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After being redirected back to the Integration Hub, repeat the above steps (this time your provided OAuth will be shown), enter a name for your authentication, and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Done"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-source","__idx":4},"children":["Create a Source"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open Treasure Console"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations Hub > Authentications"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Locate your new authentication and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New Source"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the first step ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1 - Connection"]},", type a source name in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data Transfer Name"]}," field, and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"identify-the-source-data","__idx":5},"children":["Identify the source data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Identify what data to be ingested into Treasure Data using the parameters below, and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-import-integration-2024-12-11-1.044522dca7f1b31e29c9413a5a17d786f70471375fe13fe4c6e15256f4d25b3e.899d1e34.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To support backward compatibility, this integration utilizes the API V1 for the data objects below:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contacts, with custom attributes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Companies, with custom attributes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact Lists"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Email events"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Engagement activities"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Deals, with custom attributes"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Contact Lists v1 sunset — action required"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HubSpot sunset the Contact Lists v1 API on 2026-04-30. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact_lists"]}," target now calls ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /crm/v3/lists/search"]}," and returns the v3 schema, which differs from v1:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Removed columns"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metaData"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["archived"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["internalListId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dynamic"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["portalId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleteable"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listType"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type changes"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updatedAt"]}," are now ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STRING"]}," (v3 returns string IDs and ISO-8601 timestamps; previously ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LONG"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New columns"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listVersion"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processingType"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processingStatus"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["objectTypeId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filtersUpdatedAt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdById"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updatedById"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additionalProperties"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Downstream tables and queries that depend on the v1 column names or numeric ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listId"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updatedAt"]}," must be updated."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["References: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.hubspot.com/changelog/extension-contact-lists-api-v1-sunset-moved-to-april-30-2026"},"children":["Contact Lists v1 sunset"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.hubspot.com/docs/api-reference/legacy/crm/lists/v1-migration-guide"},"children":["v1 → v3 migration guide"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API V1 allows the incremental loading of Contacts, Companies, and Email events"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Start date"]},": date from which to fetch data objects in HubSpot"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Number of days to fetch"]},": Number of days to fetch. A maximum of the past 30 days can be fetched"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Known limitations of the API V1:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Not all custom attributes are supported"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A data import has an upper limit of 10,000 records"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Migrating from API v1 targets to API v3 Search"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API v1 targets below remain functional but are subject to HubSpot's ongoing v1 sunsets. To avoid future breakage, switch to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}," target (API v3):"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Before"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["After"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target: contacts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target: search"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object_name: contacts"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["incremental_column: lastmodifieddate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target: companies"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target: search"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object_name: companies"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["incremental_column: hs_lastmodifieddate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target: deals"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target: search"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object_name: deals"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["incremental_column: hs_lastmodifieddate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target: engagements"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Split into one job per engagement type — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target: search"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object_name: calls"]}," (or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["emails"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["meetings"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notes"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tasks"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," the v3 schema differs from v1. Column names and types will change in your destination table."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The API V3"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A newer API version, the API V3, is used to support more data objects and bypass the 10k recordslimitation"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Source"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API v3 Search"]},": select this option and declare the data object name to be imported in the next field"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API v3 Properties"]},": use this option in case you would like to explore available attributes of data objects on your HubSpot account"]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Object Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The data object name to be imported. (For a full list of supported data objects, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.hubspot.com/beta-docs/guides/api/crm/search"},"children":["HubSpot"]},".)"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Objects: carts, companies, contacts, deals, deal_split, discounts, feedback_submissions, fees, invoices, leads, ..."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Engagements: calls, emails, meetings, notes, tasks"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the case of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["API v3 Properties"]},", a comma-separated list of object names can be filled in."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Incremental Column"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["(For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["API v3 Search"]}," - Mandatory) The column is used for incremental loading and/or filtering."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch All Properties"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["(For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["API v3 Search"]},") When unchecked, only the default properties of the data object will be imported."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Incremental"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["(For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["API v3 Search"]},") When checked, only the new data since the last execution will be imported."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Start Date Time  End Date Time"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["(For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["API v3 Search"]},") Data within Start - End time will be imported. These options are useful for initial data loading."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"define-data-settings","__idx":6},"children":["Define Data Settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Optionally, you can modify advanced data settings. Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]}," to move to the next step."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/google-ads-import-integration-v2-2024-08-06-5.9673dac09cfdafcf311c3895320451d2e018d8e5f17d194f5c066d1649402578.7c52a81f.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"preview-your-data","__idx":7},"children":["Preview Your Data"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["4 Data Preview"]}," step, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Generate Preview"]}," to see a sample of your data before running the import (optional)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]}," to continue."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/google-ads-import-integration-v2-2024-08-06-3.d1a7264878d399f9a4e744868a69b15ed5ab861a1fd396d9ecef55513fcc8527.7c52a81f.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"define-your-data-placement","__idx":8},"children":["Define Your Data Placement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For data placement, select the target database and table where you want your data placed and indicate how often the import should run, then select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save & Run Now"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/9bcff190-9edf-477a-9bb2-71ca68a875ef.c34f58af08ad9329b71e53eb2ce3a6e83cac5070a0e24696459c451b133b39e3.69844539.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"import-from-hubspotvia-cli-toolbelt","__idx":9},"children":["Import from HubSpot via CLI (Toolbelt)"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"prerequisites-1","__idx":10},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["TD Toolbelt: install the latest version of the Treasure CLI tool: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://toolbelt.treasuredata.com/"},"children":["TD Toolbelt"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authentication ID: follow the steps above to create an Authentication for this integration on the Treasure Console. Then the ID could be seen at the last portion of its URL on the Authentication screen."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/google-ads-import-integration-v2-2024-08-06-9.fdc162a377e20998a8f41e69c38afef49bbd1ab0b84f6b913fd06fe82b2010f3.7c52a81f.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"general-steps","__idx":11},"children":["General steps"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a YML configuration file, ex: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**load.yml**"]},", referencing the created authentication in the `",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["td_authentication_id"]},"' field."," ","Refer to the below ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/int/hubspot-import-integration#h3_755695857"},"children":["Parameter Reference"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/int/hubspot-import-integration#h3_1689083776"},"children":["Example"]}," for more details"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Preview the input data (optional) using the command:"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$ td connector:preview load.yml"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Trigger the data import using the command:"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$ td connector:issue load.yml --database db-name --table table-name"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Schedule the execution using the command:"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$ td connector:create daily\\_import \"10 0 \\* \\* \\*\" db-name table-name load.yml"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"parameters-reference","__idx":12},"children":["Parameters Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the parameters for configuring the HubSpot import integration via CLI."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Name"},"children":["Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default value"},"children":["Default value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td_authentication_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your authentication id, obtained in the UI"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numeric"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Source. Enum of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["engagements"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companies"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deals"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact_lists"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email_events"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["properties"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additional_properties"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Additional Custom Properties. Only applicable in case target is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companies"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deals"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object_names"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Comma separated object names for fetching object's properties. Only applicable when target is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["properties"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes if target is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["properties"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Object to be ingested when using search API v3. Only applicable in case target is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes if target is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["incremental_column"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Column used to do incremental loading when using search API v3. Only applicable in case target is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["String"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fetch_all_properties"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Decides whether or not to get all object's properties. This may add latency to the execution if checked but will provide more information. Only applicable in case target is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["incremental"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether or not to import new data from last run only. Only applicable in case target is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companies"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deals"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email_events"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from_date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Start Date to ingest data (in ISO-8601 format). Only applicable when incremental is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," and target is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["engagements"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companies"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deals"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact_lists"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email_events"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Datetime"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fetch_days"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number of days to fetch date from start date. Only applicable when incremental is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," and target is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["engagements"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companies"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deals"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact_lists"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email_events"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start_time"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Start time to ingest data (in ISO-8601 format). Only applicable in case target is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Datetime"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_time"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["End time to ingest data (in ISO-8601 format). Only applicable in case target is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Datetime"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example","__idx":13},"children":["Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"in:\n  type: hubspot\n  td_authentication_id: 330392\n  additional_properties: \"prop_1, prop_2, prop_3\"\n  custom_properties_chunk_size: 100\n  retry_intial_wait_msec : \"500\" # initial waiting time as 0.5 second\n  retry_limit : \"10\"\n  max_retry_wait_msec :  \"90000\" # maximum 1.5 minute of waiting time for each retry\n  from_date: 2016-09-01T00:00:00.000Z\n  fetch_days: 2\nout:\n  mode: append\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-topics","__idx":14},"children":["Related Topics"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/int/scheduling-a-data-connector-job-execution-from-the-cli"},"children":["Scheduling Using TD Toolbelt"]}," for periodic execution of this integration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/int/using-td-workflow-with-td-integrations"},"children":["Using Treasure Workflow with Integrations"]}," to trigger your created Source from a workflow"]}]}]},"headings":[{"value":"Hubspot Import Integration","id":"hubspot-import-integration","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Static IP Address of Treasure Data Integration","id":"static-ip-address-of-treasure-data-integration","depth":2},{"value":"Create a New Authentication on the Treasure Console","id":"create-a-new-authentication-on-the-treasure-console","depth":2},{"value":"Create a Source","id":"create-a-source","depth":2},{"value":"Identify the source data","id":"identify-the-source-data","depth":3},{"value":"Define Data Settings","id":"define-data-settings","depth":3},{"value":"Preview Your Data","id":"preview-your-data","depth":3},{"value":"Define Your Data Placement","id":"define-your-data-placement","depth":3},{"value":"Import from HubSpot via CLI (Toolbelt)","id":"import-from-hubspotvia-cli-toolbelt","depth":2},{"value":"Prerequisites","id":"prerequisites-1","depth":3},{"value":"General steps","id":"general-steps","depth":3},{"value":"Parameters Reference","id":"parameters-reference","depth":3},{"value":"Example","id":"example","depth":3},{"value":"Related Topics","id":"related-topics","depth":2}],"frontmatter":{"seo":{"title":"Hubspot Import Integration"}},"lastModified":"2026-06-01T09:09:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/int/hubspot-import-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}