How to Use the HubSpot Contact LinkedIn URL Finder

Before you start

• This Phantom uses URL finder credits to perform online lookups and find profile or company URLs:
  • Each lookup uses one credit, and your monthly limit depends on your plan.

Step 1: Connect your HubSpot account

1. Click Connect and authorize PhantomBuster to access your HubSpot account.
   • You only need to do this once, your HubSpot account will remain linked for future Phantoms.
2. Contact update only (Optional):
   • Enable if you want to update existing HubSpot records without creating new ones.
   • Before you can use this checkbox, you must first activate it in your Workspace Settings:
     1. Click your profile menu in the top right corner.
     2. If you have more than one workspace, make sure the correct one is selected from the dropdown. Look for the ✔️ symbol next to the active workspace name.
     3. Under your Workspace section, click Settings. 
        
     4. Check the box Contact update only.
        
     5. Once enabled, the checkbox will automatically be checked in all HubSpot Phantoms.
3. Select your HubSpot contact segment:
   • Use the dropdown to select the segment you want to enrich with LinkedIn profile URLs.

Step 2: Map PhantomBuster fields to your HubSpot contact properties

In the Behavior step, decide where to store each piece of data PhantomBuster finds.

• By default, PhantomBuster automatically creates a “LinkedIn Profile URL” property in HubSpot to store the link for each contact.
• If you already have a custom property for this data, you can select it instead to keep your CRM organized and consistent.

How matching works

The HubSpot Contact LinkedIn URL Finder matches contacts based on:

• Name + Company
• Or: Name + Email (not on LinkedIn ID).

This method ensures accurate identification even when contacts aren’t directly connected to you on LinkedIn.

→ If you also want to find professional email addresses for your contacts, use the Professional Email Finder Phantom.

Step 3: Select launch frequency

Choose how often the Phantom should run:

1. Launch manually: Start the Phantom yourself whenever you need.
2. Launch once at a specific time: schedule a one-time run at a set date and time.
3. Launch repeatedly: schedule regular runs (e.g. once per day, several times during working hours).
4. Launch after another Phantom: chain automations together so this Phantom starts right after another finishes.
5. Advanced scheduling: customize the exact minutes, hours, days, or months when the Phantom should run.

→ For a complete walkthrough of scheduling options, see our guide to scheduling Phantoms automatically.

Step 4 (Optional): Advanced settings

Advanced settings are available if you want to fine-tune how your Phantom runs, but by default they’re already optimized for most use cases.

We recommend leaving them as they are unless a guide specifically instructs you to change something.

→ For a detailed overview of all advanced options (like execution limits, retries, email notifications, proxies, webhooks, and file management), see our Advanced settings guide.

Launch and results

When you’re ready:

1. Click Launch to start your Phantom.
2. Once it finishes, open the Results tab in the Phantom console to review which contacts were updated.
3. Download your results as a CSV or JSON file.

→ To learn how to export your data to Google Sheets, integrate with other tools, or reuse it in more automations, check our Access and Export your Phantom Results guide.

Export and input limits on the Free plan
If you’re on the Free plan or Free trial, some features are limited:
- CSV exports include only the first 10 rows of results.
- CSV download links (for dynamic viewing in Google Sheets or integrations) are not available.
- JSON exports are not available.
- CSV upload as an input method is not supported.
To unlock all features, you’ll need to upgrade to a paid plan.

What you give (Input) and What you get (Output)

This section gives you a detailed breakdown of everything you need to provide to run this Phantom, and everything you’ll receive once it completes.

What you give (Input)

What you get (Output)

Tips and troubleshooting

Common pitfalls

• Incomplete contact data → Contacts missing name or company are harder to match.
• HubSpot sync delay → It can take a few minutes for updated fields to appear in your CRM.
• By default, when the Phantom detects that a contact has changed companies, it will:
  • Create a new contact for the new company,
  • And Flag the old one as “No longer at company” in HubSpot.
  • This approach follows HubSpot’s best practice: keeping one record per professional email to preserve history and past activities.
  • If you prefer to update the existing contact instead of creating a new one, you can enable the “Contact update only” option from your workspace settings page.

If you run into issues

• Check how to troubleshoot your phantom using Logs.
• Browse the Fix Issues & Troubleshoot Errors section for solutions to common problems.
• Review our Automation Rate Limits by Platform guide.
• Check our Best Practices for Social Media Automation guide.

Suggested automations

• HubSpot Contact Data Enricher → Add job titles, companies, and professional details once LinkedIn URLs are found.
• HubSpot Contact Sender → Push newly enriched contacts from PhantomBuster to HubSpot.
• LinkedIn Search Export → Build new lead lists to feed future HubSpot enrichment.