How to Sync Notion Contacts to HubSpot with NoteLinker

If your team tracks contacts in Notion but manages deals out of HubSpot, you already know the gap. Discovery notes, lead research, and conversation context sit in Notion pages while your CRM shows empty timelines. Moving a handful of contacts manually is already annoying. Moving a hundred is not realistic. The good news is that syncing Notion contacts to HubSpot takes only a few minutes when you have the right setup.

This guide walks through each step of the process. If you prefer to watch it live, the video below covers the same workflow end to end.

1. Install NoteLinker from the HubSpot Marketplace

The starting point is the HubSpot App Marketplace. Search for NoteLinker and click install. NoteLinker uses a standard OAuth flow, so no API keys or developer credentials are required. HubSpot will prompt you to confirm the permissions NoteLinker needs to write notes to contact timelines, and once you approve, the connection is live.

This step takes under a minute and only needs to happen once per HubSpot portal. If your team shares a portal, any rep on the account can begin syncing their Notion pages the moment the app is installed. You do not need to be a HubSpot admin to use NoteLinker, though admin approval may be required to install third-party apps depending on your portal settings.

2. Connect Your Notion Workspace

After HubSpot is connected, NoteLinker will prompt you to authenticate with Notion. Click the Notion connection button and follow the OAuth prompt. Notion will ask which pages and databases NoteLinker is allowed to access. You can be selective here: if your Notion workspace includes internal docs, personal pages, or content unrelated to sales, you can restrict access to just the databases that hold your contact notes.

Scoping access this way keeps things clean. NoteLinker only sees what you grant it, and your private pages stay private. Once the authorization is complete, your selected Notion databases will appear inside the NoteLinker dashboard, ready to be configured for sync.

3. Prepare Your Notion Contacts Database

NoteLinker matches your Notion rows to HubSpot contacts using an identifier, typically an email address. Before syncing, make sure your Notion database has an email property on each row. The property name does not need to match exactly, but the values need to correspond to real HubSpot contact records. If a contact exists in HubSpot under jane@company.com, the Notion row for that contact needs the same email in its email field.

You should also check that your notes are in a reasonable state before syncing. NoteLinker will push the page content of each Notion row to the matched HubSpot contact timeline. If some rows are half-finished drafts or contain placeholder text you haven't cleaned up, this is a good moment to do that. The sync is designed to send what's there, not filter it, so starting with clean notes means clean CRM records from day one.

4. Map Your Contacts to HubSpot Records

Inside NoteLinker, select the Notion database that contains your contact notes. You will be asked to tell NoteLinker which Notion property holds the email address for each row. Select it from the dropdown and NoteLinker will use that value to look up the matching HubSpot contact when the sync runs.

You can also configure what gets synced from each Notion page. By default, NoteLinker sends the full page content, preserving the headers, bullet points, and rich text formatting you wrote in Notion. If you want to include additional context such as the page title or a specific property value at the top of the note, NoteLinker lets you customize the note header before it lands in HubSpot. This is useful when a single contact has multiple Notion pages and you want each timeline entry to be clearly labeled.

5. Run the Sync and Verify the Results

With the mapping configured, click Sync. NoteLinker will process each row in your Notion database, match it to the corresponding HubSpot contact by email, and post the page content as a native note on that contact's timeline. For a database with 100 contacts, this typically completes in under two minutes.

Once the sync finishes, open a few HubSpot contact records and confirm the notes landed correctly. You should see each Notion page appear as a timeline activity with the original formatting intact. If a contact's email in Notion did not match any HubSpot record, NoteLinker will flag those rows so you can review and correct them without losing any data. From this point forward, syncing updated notes is a single click, and your team's HubSpot timelines will always reflect what's in Notion.