Setting up LinkedIn matching and the Profile Finder

Why LinkedIn matching matters

When a Signal detects social activity from one of your monitored contacts, the platform needs to link that activity back to the correct HubSpot contact record. It does this by matching the LinkedIn username or profile URL from the activity against a property on your HubSpot contacts.

Without this configured, Engagement Sync and Job Change Monitoring won't run — they have no way to know which HubSpot contact to update.

Configuring the LinkedIn match property

Go to Integrations → HubSpot → Social Sync tab.

Primary match property

Select the HubSpot contact property that stores your contacts' LinkedIn profile URL or username. This is typically a custom property — common names include linkedin_account, linkedin_url, or linkedin_profile.

If you're not sure which property to use, check your HubSpot contact records and look for the field where LinkedIn profile links are stored.

Fallback match property (optional)

If no match is found in the primary property, the platform can try a second HubSpot property. This is useful if LinkedIn data is stored inconsistently across your contacts — some in one property, some in another.

Testing the match

Use the Test match tool to verify your configuration before running sync rules. Enter a LinkedIn profile URL (e.g. https://www.linkedin.com/in/username) and click Test. The platform searches your HubSpot contacts using your configured properties and shows whether a matching contact was found.

Always test with a contact you know exists in HubSpot before relying on the match for live sync rules.

LinkedIn Profile Finder

Cost: -10 credits per valid result

Some contacts in your HubSpot account won't have a LinkedIn profile URL stored. Without it, the platform can't match them for social monitoring.

The LinkedIn Profile Finder solves this automatically. When enabled, it searches for the LinkedIn profile of any contact that's missing one — using their name, company, and other available data. When a profile is found, the result is written back to the contact's LinkedIn property in HubSpot.

Credits are only charged for valid profile results. If no profile is found, no credit is charged.

Enabling the Profile Finder

In the Social Sync tab, find the LinkedIn Profile Finder section:

1. Toggle it on.

2. Set Max attempts per run — the maximum number of profile lookups per import run (1–200, default 50).

The finder runs automatically during each sync rule import cycle. It only attempts lookups for contacts that are missing a LinkedIn profile in the configured match property.

Saving your settings

Click Save Configuration after configuring your match properties and Profile Finder settings. Rules are saved separately when you create or edit them.

Common issues

Sync rules running but no notes appearing in HubSpot The most likely cause is that your LinkedIn match property isn't populated for most contacts. Use the Test match tool with a few contacts to verify matches are being found. Consider enabling the Profile Finder to fill gaps.

Profile Finder not finding results The finder works best when contacts have accurate name and company data in HubSpot. Contacts with minimal data (e.g. only an email address) are harder to match.