Skip to main content

Notion

Available

This integration is active and ready to use in Frihet.

Connect your Notion workspace to Frihet. Search for pages, query databases, and access project and client information directly from your ERP without switching applications.

What is it for?​

With Notion integrated:

  • Search pages — Find any page in your workspace from Frihet
  • List databases — View all your Notion databases
  • Query records — Query databases with filters
  • Project context — Access project information linked to invoices
  • Accessible documentation — Consult SOPs, contracts, or briefs without leaving the ERP

Requirements​

  • Active Notion account — notion.so
  • Internal Integration Token — Created from Notion's integration settings
  • Frihet Pro or higher

Connect Notion with Frihet​

Step 1: Create an internal integration in Notion​

  1. Go to notion.so/my-integrations
  2. Log in with your Notion account
  3. Click on New integration
  4. Configure the integration:
    • Name: "Frihet ERP"
    • Associated workspace: Select your workspace
    • Capabilities: Check at least "Read content" and "Read user information"
  5. Click on Submit
  6. Copy the Internal Integration Token (starts with ntn_...)
Save the token

The token can be viewed later, but copy it now so you don't have to return.

Step 2: Share pages with the integration​

Notion requires you to explicitly share pages or databases with your integration:

  1. Open the page or database you want Frihet to be able to see
  2. Click on ... (page menu) → Connections
  3. Search for "Frihet ERP" (your integration's name)
  4. Click to add it
  5. Repeat for each page or database you need
Only what you share

The integration can only access the pages and databases you explicitly share. It does not have access to your entire workspace.

Step 3: Configure in Frihet​

  1. Go to Settings → Integrations
  2. Search for Notion
  3. Click on Connect
  4. Paste your Internal Integration Token (ntn_...)
  5. Click on Verify connection
  6. If successful, you will see your workspace name

How it works​

Frihet uses the Notion API (version 2022-06-28):

  1. You provide your Internal Integration Token
  2. Frihet sends the token in the Authorization: Bearer ntn_... header
  3. Additionally, it includes the Notion-Version: 2022-06-28 header in each request
  4. Searches and queries are performed on demand
  5. The token is stored encrypted (AES-256-GCM) in Frihet

Synced Data​

DataDirectionFrequency
Pages (search)Notion → FrihetOn demand
Databases (listing)Notion → FrihetOn demand
Database recordsNotion → FrihetOn demand (query)
Page propertiesNotion → FrihetWith each query

Features​

Search pages​

Search any page shared with the integration by title or content:

  1. From Frihet, use the Notion search function
  2. Type the search term
  3. Frihet returns matching pages
  4. Click on a result to view details or open in Notion

List databases​

View all databases shared with the integration:

  1. Frihet queries all accessible databases
  2. Shows name, description, and number of records
  3. Select one to query its records

Query databases​

Query a database with filters:

  1. Select the database
  2. Apply filters (by property, status, date, etc.)
  3. Frihet displays matching records
  4. Useful for querying, for example, a database of clients or projects

Import contacts​

You can import contacts from any Notion database:

  1. Connect your Notion account
  2. Select the database that contains your contacts
  3. Frihet automatically detects the fields: name, email, address, and tax ID
  4. Contacts are imported as clients in Frihet
  5. Duplicates are detected by name (not imported twice)

Frihet searches for fields with names like "Name", "Email", "Address", "Tax ID", "NIF" in both English and Spanish.

Use Cases​

Client database in Notion​

You maintain a client database in Notion with fields such as company, contact, and notes. From Frihet, you query that database to get context when creating an invoice.

Project documentation​

You have the documentation for each project in Notion (briefs, contracts, scope). When invoicing a project, you query the Notion page directly from Frihet to verify the agreed scope.

Light CRM​

You use Notion as an informal CRM with a database of deals. From Frihet, you query the status of each deal to know when it's time to send an invoice.

Troubleshooting​

"Authentication error"​

  • Verify that the token is correct and starts with ntn_
  • Check that the integration has not been deactivated in Notion
  • If you regenerated the token, update it in Frihet

"Cannot find my pages"​

  • The integration only sees the pages you explicitly share with it
  • Open the page in Notion → ... → Connections → Add your integration
  • Child pages of a shared page are automatically accessible

"Cannot access a database"​

  • Share the database with the integration (same process as with pages)
  • Verify that the integration has "Read content" capability activated

"Data is outdated"​

  • Queries to Notion are real-time (on demand)
  • If you don't see recent changes, refresh the view in Frihet
  • Notion may take a few seconds to reflect very recent changes

"I want to disconnect"​

  1. Go to Settings → Integrations → Notion
  2. Click on Disconnect
  3. Optionally, deactivate or delete the integration at notion.so/my-integrations

Next steps​