Skip to main content

HubSpot CRM

Available

This integration is available in Frihet. Configure it in Settings → Integrations → HubSpot CRM.

Connect your HubSpot CRM account to Frihet to import your contacts as clients. If you use HubSpot to manage your sales pipeline and business relationships, this integration allows you to bring those contacts into Frihet to invoice them directly, without duplicating data or manual entry.

What is it for?​

  • Import contacts as clients — HubSpot contacts are converted into Frihet clients with name, email, phone, company, and address
  • Elimination of double entry — You do not need to recreate in Frihet the clients you already have in HubSpot
  • Unified client base — Maintain a single source of client data that flows from your CRM to your ERP
  • Immediate invoicing — Once imported, you can create invoices for those clients directly from Frihet

Requirements​

  • Active account in HubSpot
  • Frihet Pro or Business plan
  • Private App with access token in HubSpot (needs the crm.objects.contacts.read scope)

How to connect​

Step 1: Create a Private App in HubSpot​

  1. Log in to app.hubspot.com
  2. Go to Settings (gear icon in the top bar)
  3. In the sidebar menu, navigate to Integrations → Private Apps
  4. Click Create a private app
  5. In the Basic Info tab:
    • Name: "Frihet ERP"
    • Description (optional): "Import contacts to Frihet"
  6. In the Scopes tab, find and activate:
    • crm.objects.contacts.read — Read contacts
  7. Click Create app and confirm
  8. Copy the Access Token displayed. This is the token you will use in Frihet.

Step 2: Configure in Frihet​

  1. In Frihet, go to Settings → Integrations
  2. Find HubSpot CRM and click on the card
  3. Paste your Access Token (Private App token) into the corresponding field
  4. Click Test connection to verify
  5. If the connection is successful, click Save

How it works​

Frihet connects to the HubSpot API using your Private App's access token. When you initiate an import, Frihet queries the contacts in your HubSpot account and creates them as clients in Frihet.

The import is on demand. Contacts already imported are identified by their HubSpot ID and are not duplicated in subsequent imports.

Data mapping​

HubSpot DataFrihet Field
First name + Last nameClient Name
EmailClient Email
PhoneClient Phone
CompanyClient Company
Address, City, State, Zip, CountryClient Address

Use cases​

Agency that closes deals in HubSpot​

Your sales team manages the pipeline in HubSpot. When a deal closes, you import the contact into Frihet to create the invoice. You don't need to ask the client for their data again or copy it manually.

Consulting firm with client base in HubSpot​

You have hundreds of contacts in HubSpot accumulated over years. Instead of manually creating each client in Frihet, you perform a bulk import and your invoicing database is instantly ready.

Freelancer with HubSpot Free​

You use HubSpot's free CRM to manage contacts. When you need to invoice a contact, you import them into Frihet with a click and create the invoice with all the data already completed.

Troubleshooting​

Connection error​

  • Verify that the Private App access token is correct
  • Check that the Private App has the crm.objects.contacts.read scope enabled
  • If you deleted and recreated the Private App, the previous token will no longer work — update it in Frihet

Contacts not imported​

  • Make sure you have contacts in your HubSpot account
  • Verify that contacts have at least a name or email (contacts without data are skipped)
  • Check that the Private App has not been deactivated in HubSpot

Incomplete data in imported clients​

  • Only fields with data in HubSpot are imported
  • If a contact does not have a phone or address in HubSpot, those fields will remain empty in Frihet
  • You can complete the data directly in Frihet after the import

Next steps​