Skip to main content

n8n

Available

This integration is active and ready to use on all Pro plans.

Connect Frihet to n8n to automate workflows: automatic reminders, CRM synchronization, custom notifications, and more.

What is it for?​

With n8n integrated:

  • Automatic Reminders — Sends emails when an invoice is due
  • CRM Synchronization — New clients are created in Salesforce, Pipedrive, etc.
  • Custom Notifications — Slack, email, Telegram, custom webhook
  • Complex Workflows — Conditionals, loops, logical branching
  • Webhook endpoints — Other systems trigger actions in Frihet

Requirements​

Get Frihet credentials​

In Frihet​

  1. Go to Settings → Integrations → n8n
  2. Click on "Generate API Key"
  3. Copy the key (something like: fh_live_XXXXXXXXXXXXXXXXX)
  4. Click on "Create Webhook"
  5. Copy the webhook URL (to receive events)

Store both in a safe place.

Connect Frihet to n8n​

Step 1: Create workflow in n8n​

  1. Go to n8n.io
  2. New workflow
  3. Add node: Frihet (search for it)

Step 2: Configure credentials​

  1. In the Frihet node, go to Credentials
  2. Click on "Create new credential"
  3. Paste the Frihet API Key
  4. Save

Step 3: Choose action​

In the node, choose what to do:

  • Create invoice
  • Create expense
  • Create client
  • Get client list
  • Get invoice list
  • Mark invoice as paid

Common use cases​

Due date reminder​

When: Every morning at 9am What it does: Searches for overdue invoices and sends email to the client

n8n workflow:
1. Trigger: Every day at 09:00
2. Frihet Node: Get overdue invoices
3. Loop: For each invoice
4. Email Node: Send reminder email
5. Update in Frihet: Mark "Reminder sent"

New client → CRM​

When: Client is created in Frihet What it does: Automatically adds it to Salesforce/Pipedrive

n8n workflow:
1. Trigger: Frihet Webhook (new client)
2. Frihet Node: Get client data
3. Salesforce Node: Create contact
4. Email Node: Notify the team

Invoice paid → Slack Notification​

When: An invoice is marked as paid What it does: Sends notification to Slack with details

n8n workflow:
1. Trigger: Frihet Webhook (invoice paid)
2. Frihet Node: Get invoice details
3. Slack Node: Send formatted message
4. Sheet Node: Register in Google Sheets (optional)

Create invoice from form​

When: Someone completes a form What it does: Automatically creates invoice in Frihet

n8n workflow:
1. Trigger: Form Webhook (TypeForm, Typebot, etc.)
2. Node: Process form data
3. Frihet Node: Create invoice
4. Email Node: Confirm to the client

Pre-configured templates​

n8n and Frihet offer ready-made templates:

  1. In n8n, go to Community → Templates
  2. Search for "Frihet"
  3. Choose a template
  4. Click on "Use this template"
  5. Just configure credentials

Available templates​

  • "Overdue invoice reminder"
  • "Sync clients to Airtable"
  • "Payment notifications in Slack"
  • "Create invoices from Typeform"
  • "Daily backup to Google Drive"

Use them as a base and customize.

Frihet Webhook​

Frihet automatically sends events to n8n. Consult the full webhooks documentation for details on HMAC-SHA256 signature, retries, and all event types.

Events that trigger webhook​

EventData sent
Invoice createdID, client, amount, due date
Invoice paidID, client, amount, payment date
Overdue invoiceID, client, amount, days overdue
Client createdID, name, email, phone
Expense createdID, category, amount, date
Payment receivedInvoice ID, client, amount

Configure webhook in Frihet​

  1. Settings → Integrations → n8n
  2. Click on "Create Webhook"
  3. Choose which events to trigger (recommended: all)
  4. Copy the webhook URL
  5. In n8n, configure a "Webhook" node as a trigger with that URL

Available actions in Frihet​

Create invoice​

Input:
- Client ID (or create new)
- Concept
- Amount
- Due date
- VAT

Output:
- Created invoice ID
- Document number
- Status

Create expense​

Input:
- Category
- Amount
- Date
- Vendor (optional)

Output:
- Expense ID
- Confirmation

Get list​

Input:
- Filter (date, client, status)
- Result limit

Output:
- Array of invoices/expenses/clients

Mark as paid​

Input:
- Invoice ID
- Amount (optional)
- Payment method (optional)

Output:
- Confirmation
- Update date

Full example: Daily reminder​

Objective​

Every morning at 8am, if there are overdue invoices, send an email to the client.

Workflow in n8n​

Step 1: Trigger

Scheduler: Every day at 08:00
Timezone: Europe/Madrid

Step 2: Get overdue invoices

Node: Frihet
Action: Get Invoices
Filter: State = "unpaid" AND Due Date < Today

Step 3: Loop over each invoice

Loop Node: For each invoice in the result
  - Get client email
  - Calculate days overdue

Step 4: Send email

Node: Gmail / SendGrid
To: client email
Subject: "Invoice #{{$node.Frihet.data.number}} to collect"
Body:
  "Your invoice {{id}} for {{amount}} euros
   is overdue by {{days_overdue}} days.
   Please make the payment as soon as possible.
   [Payment link]"

Step 5: Update in Frihet

Node: Frihet
Action: Update Invoice
Update: reminder_sent = true
Update: reminder_date = today

Bidirectional synchronization with CRM​

Create client in Frihet → Salesforce​

1. Trigger: Frihet Webhook (client created)
2. Frihet: Get client data
3. Salesforce: Create Account
4. Salesforce: Create Contact
5. Frihet: Save Salesforce ID in client

Create deal in Salesforce → Invoice in Frihet​

1. Trigger: Salesforce Webhook (deal won)
2. Salesforce: Get deal data
3. Frihet: Create client (if new)
4. Frihet: Create invoice with deal amount
5. Salesforce: Update deal with link to Frihet

Custom notifications​

Option 1: Email​

Node: Gmail / SendGrid
Custom template with:
  - Your company logo
  - Invoice details
  - Payment link

Option 2: Slack​

Node: Slack
Message:
  ":moneybag: Invoice paid
   Client: {{client}}
   Amount: €{{amount}}
   Status: Paid ✅"

Option 3: WhatsApp/Telegram​

Node: Telegram / WhatsApp (via Twilio)
Message:
  "Hello {{name}},
   Your invoice #{{id}} is due in 3 days.
   [Pay here]"

Option 4: Custom webhook​

If you have your own system:

Node: HTTP POST
URL: https://your-system.com/frihet-webhook
Body:
  {
    "event": "invoice_paid",
    "invoice_id": "...",
    "amount": 1200,
    "client": "..."
  }

Your system processes as needed.

Conditions and logic​

You can add conditions:

IF invoice overdue MORE THAN 7 DAYS
  THEN send email + create task
ELSE IF overdue LESS THAN 7 DAYS
  THEN only send email
ELSE
  THEN do nothing

Or more complex branching:

IF client is "Premium"
  THEN call by phone
ELSE IF client is "Regular"
  THEN send email
ELSE
  THEN ignore

Testing and debugging​

Execute workflow manually​

  1. In n8n, click on "Execute"
  2. You see results step by step
  3. If there is an error, it shows it with details
  4. Adjust and re-execute

Logs and history​

  1. Go to Executions in your workflow
  2. You see each execution:
    • When it was executed
    • If it was successful
    • Execution time
    • Results of each node

Test with test data​

Before activating (scheduling), test:

  1. Edit the trigger to Manual
  2. Click on "Execute" several times
  3. Verify that each node works
  4. Then change to Automatic Trigger (scheduler)

Limits and costs​

In n8n​

  • Automatic Workflows: Depends on your plan
  • Executions: Free up to a certain limit
  • Nodes: Unlimited
  • Integrations: Hundreds available

In Frihet​

  • API calls: Included in Pro (no additional limit)
  • Webhooks: Unlimited
  • Data: No special limit for n8n

Troubleshooting​

"Webhook not triggering"​

  • Verify that the webhook is active in Frihet
  • The event must match the configuration
  • Check n8n logs: Executions → history
  • If there's an HTTP error, check webhook status

"Error: No credentials found"​

  • In n8n, verify that credentials are saved
  • Copy the Frihet API Key again
  • Recreate the credential

"How to debug if something is not working?"​

  1. Add a "Log" node between steps to see intermediate data
  2. Execute manually step by step
  3. Go to Executions → full history
  4. Search for the error in the logs

"Can I use multiple workflows?"​

Yes. You can have:

  • Workflow 1: Daily reminders
  • Workflow 2: CRM synchronization
  • Workflow 3: Automatic backups
  • All running in parallel

Next steps​

Previous: Revolut Business