Skip to main content

How to Set up HubSpot Integration

A
Written by Alex Terez

Native HubSpot integration allows you to automatically sync lead information from your Dripify campaigns to HubSpot without using third-party tools.

You can keep your existing HubSpot contacts up to date and, with a HubSpot Service Key, automatically create new contacts when they don't already exist in your CRM.

Follow the steps below to connect HubSpot to Dripify and configure the integration.

Step 1. Connect HubSpot to Dripify in Settings

  1. Go to “Settings”;

  2. Click “Integrations”;

  3. Find the “HubSpot” integration option and click “Connect” to begin the integration set up.

Once the connection is successful, you'll see a confirmation notification.

⚠️ Note: Only one HubSpot account can be connected at a time.

Step 2. Configure field mapping

Field mapping is a mandatory step that determines which lead information from Dripify is transferred to the corresponding properties in HubSpot.

The following 21 Dripify lead fields are available for mapping:

  1. First name

  2. Last name

  3. LinkedIn profile URL

  4. Conversation

  5. Custom email

  6. Corporate email

  7. LinkedIn email

  8. Country

  9. City

  10. Position

  11. LinkedIn Premium status

  12. Website

  13. Phone number

  14. Company name

  15. Company website

  16. Industry

  17. Number of company employees

  18. Number of company followers

  19. Education

  20. Campaign name

  21. Lead source

Once the required fields are selected, click “Save”.

You can map each Dripify field to the corresponding HubSpot property or select Don't map if you don't want to transfer that information.

Please note:

  • Email fields: Custom email, Corporate email, and LinkedIn email can be mapped separately. Dripify only transfers an email address if the corresponding HubSpot property is empty, so existing email values won't be overwritten.

  • Lead source: You can map this field to a HubSpot property to identify contacts synced from Dripify. The transferred value will always be Dripify.

  • Conversation: This field is transferred to the mapped HubSpot property only when the After LinkedIn reply is received trigger is activated. The conversation is also automatically saved in the contact's activity history in HubSpot, regardless of field mapping.

Step 3. Enable new contact sync with a Service Key (optional)

By default, the HubSpot integration allows Dripify to update contacts that already exist in your HubSpot account.

To create new HubSpot contacts when no matching contact is found, you'll need to connect a HubSpot Service Key.

After completing field mapping, the New contact sync section will appear in your HubSpot integration settings.

To enable new contact synchronization:

  • Click the information icon next to How to create a new Service Key in HubSpot.

  • In the instructions that appear, click Open Service Keys in HubSpot to access the corresponding settings in your HubSpot account.

  • Create a new Service Key named Dripify and add the required permissions (scopes) listed in the instructions.💡Hint! You can copy the scopes directly from the instructions in Dripify.

  • Generate the Service Key and copy its token.

  • Return to Dripify and paste the token into the Paste your Service Key field.

  • Click Verify & Finish to validate and connect your Service Key.

⚠️ Note: You'll need Super Admin access in HubSpot to create a Service Key. If you don't have the required permissions, ask your HubSpot administrator to create one for you and share the token securely.

Once the key is successfully verified, Dripify will now be able to create new HubSpot contacts and update existing ones.

Can I skip this step?

Yes! Adding a Service Key is optional.

If you don't need to create new HubSpot contacts, click Skip this step for now. Your integration will remain active and continue updating existing contacts.

You can also add a Service Key later without reconnecting your HubSpot account. Simply go to Settings → Integrations → HubSpot, click Add Service Key under New contact sync, paste your token, and click Add Service Key to complete the setup.

Step 4. Enable HubSpot for your campaign

You can enable integrations in the Settings step when creating or editing a campaign.

In the Integrations section, you'll see the available options:

  • Webhooks

  • HubSpot

You can enable either integration or use both simultaneously within the same campaign.

If you haven't connected a Service Key, you'll see an informational message explaining that only existing HubSpot contacts can be updated.

Click Add Service Key in the message to open your HubSpot integration settings and enable new contact synchronization.

Step 5. Configure triggers

When you enable HubSpot in your campaign's integration settings, the following trigger options become available:

  • After a connection request is sent

  • After a connection request is accepted

  • After a first message is sent

  • After a LinkedIn reply is received

  • After request withdrawn

Select the events that should trigger contact synchronization with HubSpot.

Step 6. Choose a HubSpot segment

You can choose a HubSpot segment where engagement updates will be synced.

Any existing contact matched during synchronization can optionally also be included in one additional Static segment, which is automatically fetched and displayed in the dropdown.

Step 7. Launch your campaign

Once you've configured the required triggers and segments, save and launch your Dripify campaign.

Your HubSpot integration is now active, and contact information will be synchronized automatically when the selected triggers are activated.

Depending on your Service Key configuration:

1. Without a Service Key: Dripify updates existing HubSpot contacts only.

2. With a Service Key: Dripify updates existing contacts and creates new ones when no matching contact is found.

How contact synchronization works between Dripify and HubSpot

When synchronizing a lead, Dripify checks whether a matching contact already exists in your connected HubSpot account.

If a matching contact is found, Dripify updates it with the available lead information according to your field mapping settings.

If no matching contact is found, Dripify can create a new HubSpot contact, provided that a valid Service Key is connected.

💡 Important: Existing email values in HubSpot are never overwritten during synchronization.

How to manage your HubSpot Service Key

You can replace or remove your connected Service Key at any time without disconnecting your HubSpot account.

Go to Settings → Integrations → HubSpot and click Edit next to New contact sync.

  • To replace your Service Key: Paste a new token into the corresponding field and click Replace. Once the new key is successfully connected, it replaces the previous one without interrupting synchronization.

  • To remove your Service Key: Click Remove key and confirm your choice. Dripify will stop creating new HubSpot contacts, but existing contacts will continue to be updated.

You can add a Service Key again at any time to restore new contact synchronization.

⚠️ Note: Contacts that triggered synchronization while the Service Key was manually removed won't be synced retroactively after you reconnect it.

HubSpot integration disconnect

If you need to disconnect HubSpot from your Dripify campaign, click the trash icon in the campaign's integration settings.

If you manually disconnect the HubSpot integration while campaigns are running, those campaigns will continue running, but synchronization with HubSpot will stop.

If you reconnect the same HubSpot account after a manual disconnection, updates that occurred while it was disconnected won't be synchronized retroactively.

HubSpot integration error handling

If your HubSpot integration becomes disconnected or encounters an issue, Dripify will display a notification to help you identify and resolve it.

There are three types of integration errors:

1. HubSpot account disconnected

If your HubSpot account becomes disconnected due to external reasons, synchronization stops for all campaigns where HubSpot was enabled.

You'll see a notification prompting you to reconnect your account.

Click Reconnect and follow the instructions to restore your HubSpot connection in Settings → Integrations.

Once the connection is successfully restored, updates that occurred during the external disconnection will be synchronized retroactively.

2. Field mapping issues

If one or more mapped HubSpot properties are modified, deleted, or become unavailable, Dripify displays a field mapping error.

To resolve it, go to Settings → Integrations → HubSpot and update the affected field mapping.

3. Service Key stopped working

If your Service Key becomes invalid or stops working, Dripify can no longer create new HubSpot contacts.

However, your campaigns will continue running, and existing HubSpot contacts will continue to be updated.

You'll see a notification prompting you to Update Service Key.

Click the Update key to open Settings → Integrations → HubSpot, where you can replace the invalid key with a valid one.

Once the Service Key is successfully updated, new contact synchronization will resume automatically, including contacts that were skipped while the key was invalid.

Questions? Feel free to reach out to our support team via chat or [email protected] 🙌.

Did this answer your question?