How to Map Properties Between PhantomBuster and HubSpot

Sophie
Sophie This badge shows you’re hearing straight from the source! Team members are here to share insider tips, answer questions, and guide you through PhantomBuster with expert knowledge. They’re dedicated to helping you succeed and making sure your automation journey feels easy and exciting. PhantomBuster Official
  • Updated

To map properties between PhantomBuster and HubSpot, open any HubSpot Phantom's setup and use the dropdown menus to match PhantomBuster fields (like LinkedIn headline, job title, or company name) to HubSpot contact properties. You can choose to fill empty properties only or overwrite existing values. Only text and number properties are supported, and read-only properties cannot be updated.

When you connect HubSpot with PhantomBuster, your Phantoms can automatically create or update contact properties in HubSpot, helping you keep your CRM data complete and enriched.

Which Phantoms integrate with HubSpot

You can create or update HubSpot properties when using any of the following HubSpot-compatible Phantoms:

What property types you can map or update

PhantomBuster supports mapping to HubSpot text and number properties.

  • You can only update editable properties, not those marked as read-only.

    PhantomBuster HubSpot property mapping showing a read-only property that cannot be updated

  • You can map data from your PhantomBuster fields (like LinkedIn headline, job title, or company name) to matching HubSpot properties.

If a property doesn’t exist yet in HubSpot, you can create a custom contact property before mapping it.

LinkedIn Outreach actions and property mapping

LinkedIn Outreach actions, such as Invited, Accepted, or Replied, cannot be mapped to HubSpot properties.

These actions appear as activities in HubSpot on each contact’s record instead of as properties you can use for filters or segments.

If you want to use these actions for filtering or automation, you can set up a workaround with Zapier or Make. Both tools let you send LinkedIn event data from your PhantomBuster results to custom HubSpot properties for reporting or workflows.

Learn more in What to expect from the HubSpot integration.

How to map properties between PhantomBuster and HubSpot

When setting up a HubSpot Phantom for the first time, you can adjust how your data is mapped between PhantomBuster and HubSpot.

  1. Start your Phantom setup:
    • During setup, you’ll see a list of fields automatically mapped for you.
  2. Use the dropdown menus to adjust mappings:
    • Match each PhantomBuster field to the HubSpot property you want to update. 
      PhantomBuster HubSpot Phantom setup showing the dropdowns to map each field to a HubSpot property
  3. Choose the update behavior for each mapped field (Action):
    • Fill if empty: Updates the property only if it’s currently empty.
    • Overwrite: Always replaces the existing value with the new one.
  4. Add more mappings if needed:
    • Click Add property to create additional field pairs between PhantomBuster and HubSpot.PhantomBuster HubSpot Phantom setup showing the Add property button to add a field pair
    • Select an existing PhantomBuster property from the dropdown.
    • Select the HubSpot property you want it to update.

Default and custom properties created by HubSpot Phantoms

HubSpot Phantoms automatically create several contact and company properties by default to help you manage context, details, and update history.

You can also enrich your HubSpot contacts with any data a Phantom can extract from LinkedIn, such as:

  • Connection count
  • Headline
  • Bio or summary
  • Job title or description

These new properties give you powerful ways to refine your segments and personalize your outreach.

Frequently asked questions

Which Phantoms support HubSpot property mapping?

HubSpot Contact Sender, HubSpot Contact Data Enricher, HubSpot Contact Data Refresher, and LinkedIn Profile Scraper (when using HubSpot as a source).

What's the difference between "Fill if empty" and "Overwrite"?

"Fill if empty" only updates a HubSpot property if it currently has no value. "Overwrite" always replaces the existing value with the new one from PhantomBuster.

What if the HubSpot property I need doesn't exist?

Create a custom contact property in HubSpot first, then return to the Phantom setup and select it from the dropdown.

Can I map LinkedIn outreach actions like "Invited" or "Replied" to HubSpot properties?

No. LinkedIn outreach actions appear as activities on each contact's record, not as mappable properties. To use them for filtering or automation, set up a workaround with Zapier or Make to send the data to custom HubSpot properties.

Was this article helpful?

0 out of 0 found this helpful