# Integrations ## HubSpot Integration Connect Promptloop with HubSpot to seamlessly import and update your company data. This integration is available for team subscription members and is shared across the team. ### Setting Up HubSpot Connection 1. Navigate to the Integration tab in your settings 2. Click the "Connect to HubSpot" button - on the [account page](/account/settings/integrations) 3. Authorize Promptloop in HubSpot 4. You'll be redirected back with access to import and sync features <Image src='https://img.promptloop.com/hubspot_iintegration_overview-36f62ca2.png' alt='HubSpot Integration 1' width={800} height={420} /> <Callout title="Note"> Only one team member needs to set up the connection for the entire team to use it. </Callout> ### Working with HubSpot Data ### Setting up auto enrichment (5 minutes) Easily set up the default company enrichment that will run on every new company added to your HubSpot, automatically updating the company properties, providing you with the latest information on your customers or prospects. **Step 1** - Copy the [Standard HubSpot Enrichment Task](/account/custom/library/template/f4fb48bf-12cf-4adc-9824-fc7bb5c24f59) to your team - you can edit or customize this task by following the [editing instructions](docs/custom-tasks#step-3-edit-your-task) **Step 2** <Image src='https://img.promptloop.com/hubspot_auto_run_1-a54b3e29.png' alt='Configure Auto-Run Selection' width={800} height={420} /> - Navigate to [integration settings](/account/settings/integrations) and select "Configure Auto-Run" **Step 3** <Image src='https://img.promptloop.com/hubspot_select_task-1b7a836f.png' alt='Configure Auto-Run Selection' width={800} height={420} /> - Select the HubSpot Enrichment task from the drop down **Step 4** <Image src='https://img.promptloop.com/hubspot_auto_run_assigning-c507a14a.png' alt='Configure Auto-Run Selection' width={800} height={420} /> - Map the enrichment task outputs to HubSpot categories. - There are default properties for some of these in HubSpot, but you may need to add properties with the proper categories depending on your task edits. You can find instructions for that [here](https://knowledge.hubspot.com/properties/create-and-edit-properties). **Step 5** - Hit "Save Configuration" and your auto enrichment will immediately take effect on any new companies added to your HubSpot. - By selecting "Existing Auto-Runs" you can see the current Auto-Runs running, the task and version number as well as which HubSpot properties they are mapped to. You can also pause, start, or delete them from here. <Image src='https://img.promptloop.com/husbpot_existing_auto_runs-59ba35f0.png' alt='Configure Auto-Run Selection' width={800} height={420} /> <Callout title="Important"> We recommend only having a HubSpot property updated by one enrichment task. You can have many tasks performing different research enrichment on different HubSpot properties. The enrichment happens asynchronously, so if two tasks are updating the same property we can't guarantee the order and the task that finishes most recently will overwrite whatever any other tasks updated. If you make updates to the underlying enrichment task, the changes won't automatically go into effect, because the enrichment is tied to the task version. You will need to create a new Auto-Run and pause or delete the old one. </Callout> ### Importing Lists - If you want to backfill enrichment or run more complex PromptLoop research tasks, this is the best way. - Import existing HubSpot lists or your entire company database - Select specific columns to import (recommended) - The HubSpot ID (hs_object_id) is automatically included for syncing - Import process typically takes 1-5 minutes <Image src='https://web-public-photos.s3.amazonaws.com/Screenshot%202024-11-06%20at%202.30.14%20PM.png' alt='HubSpot Integration 3' width={400} height={600} /> <Image src='https://web-public-photos.s3.amazonaws.com/Screenshot%202024-11-06%20at%202.30.01%20PM.png' alt='HubSpot Integration 4' width={400} height={600} /> **Syncing Back to HubSpot** - Use "Sync to HubSpot" from the dataset page - Map Promptloop columns to existing HubSpot fields <Image src='https://web-public-photos.s3.amazonaws.com/Screenshot%202024-11-06%20at%202.31.10%20PM.png' alt='HubSpot Integration 2' width={800} height={420} /> - Create new HubSpot fields as needed - Updates are applied using the selected dataset version <Image src='https://web-public-photos.s3.amazonaws.com/Screenshot%202024-11-06%20at%202.32.03%20PM.png' alt='HubSpot Integration 5' width={800} height={420} /> ### Managing Your Connection To disconnect from HubSpot: 1. Go to the Integrations page 2. Click the disconnect button 3. Follow the confirmation prompts <Callout title="Important"> Never delete the hs_object_id column from imported datasets as it's required for syncing back to HubSpot. </Callout>

    Integrations

    HubSpot Integration

    Connect Promptloop with HubSpot to seamlessly import and update your company data. This integration is available for team subscription members and is shared across the team.

    Setting Up HubSpot Connection

    1. Navigate to the Integration tab in your settings
    2. Click the "Connect to HubSpot" button - on the account page
    3. Authorize Promptloop in HubSpot
    4. You'll be redirected back with access to import and sync features
    HubSpot Integration 1
    Note

    Only one team member needs to set up the connection for the entire team to use it.

    Working with HubSpot Data

    Setting up auto enrichment (5 minutes)

    Easily set up the default company enrichment that will run on every new company added to your HubSpot, automatically updating the company properties, providing you with the latest information on your customers or prospects.

    Step 1

    Step 2

    Configure Auto-Run Selection

    Step 3

    Configure Auto-Run Selection
    • Select the HubSpot Enrichment task from the drop down

    Step 4

    Configure Auto-Run Selection
    • Map the enrichment task outputs to HubSpot categories.
    • There are default properties for some of these in HubSpot, but you may need to add properties with the proper categories depending on your task edits. You can find instructions for that here.

    Step 5

    • Hit "Save Configuration" and your auto enrichment will immediately take effect on any new companies added to your HubSpot.
    • By selecting "Existing Auto-Runs" you can see the current Auto-Runs running, the task and version number as well as which HubSpot properties they are mapped to. You can also pause, start, or delete them from here.
    Configure Auto-Run Selection
    Important

    We recommend only having a HubSpot property updated by one enrichment task. You can have many tasks performing different research enrichment on different HubSpot properties. The enrichment happens asynchronously, so if two tasks are updating the same property we can't guarantee the order and the task that finishes most recently will overwrite whatever any other tasks updated.

    If you make updates to the underlying enrichment task, the changes won't automatically go into effect, because the enrichment is tied to the task version. You will need to create a new Auto-Run and pause or delete the old one.

    Importing Lists

    • If you want to backfill enrichment or run more complex PromptLoop research tasks, this is the best way.
    • Import existing HubSpot lists or your entire company database
    • Select specific columns to import (recommended)
    • The HubSpot ID (hs_object_id) is automatically included for syncing
    • Import process typically takes 1-5 minutes
    HubSpot Integration 3
    HubSpot Integration 4

    Syncing Back to HubSpot

    • Use "Sync to HubSpot" from the dataset page
    • Map Promptloop columns to existing HubSpot fields
    HubSpot Integration 2
    • Create new HubSpot fields as needed
    • Updates are applied using the selected dataset version
    HubSpot Integration 5

    Managing Your Connection

    To disconnect from HubSpot:

    1. Go to the Integrations page
    2. Click the disconnect button
    3. Follow the confirmation prompts
    Important

    Never delete the hs_object_id column from imported datasets as it's required for syncing back to HubSpot.