n8n

n8n is a workflow tool you run in the cloud or on your own server. The n8n-nodes-fondaro community node starts workflows when something happens in your CRM and creates, finds and updates CRM records. It ships three nodes:

Install the node

The node is published on npm as n8n-nodes-fondaro and is a verified community node, so it works on n8n Cloud and self-hosted. On n8n Cloud, search for "Fondaro" in the node panel. On a self-hosted n8n:

• From n8n: open Settings › Community Nodes, select Install and enter n8n-nodes-fondaro.
• From the command line: run this in your n8n user folder, then restart n8n.

npm install n8n-nodes-fondaro

Create an API key

1. In Fondaro, open Settings › Integrations › n8n (admins only).
2. Select Generate key and give it a name, for example "n8n production".
3. Optionally narrow its Scopes or set an Expiry, then select Generate.
4. Copy the key. It is shown only once; if you lose it, revoke it and generate a new one.

A key acts for the whole agency with admin access, limited by its scopes. Each key allows 120 requests a minute. To rotate, generate a new key, swap it into n8n, check your workflows, then Revoke the old one from its ⋯ menu.

Add the credential in n8n

1. In n8n, create a Fondaro API credential.
2. Paste the key and leave the base URL as https://api.fondaro.com.
3. Save. n8n tests the key straight away.

Start a workflow on a CRM event

Add a Fondaro Trigger node and pick the events. Activating the workflow registers the webhook with Fondaro; deactivating removes it.

Webhooks carry ids only, never contact details: fetch the record with the Fondaro node as the next step (for example Lead › Get). For a tag event, read the tag with Tag › Get. Deliveries are signed, and the trigger node rejects anything unsigned or older than five minutes.

If your endpoint keeps failing, Fondaro retries for several hours, then pauses the subscription after 20 failures in a row. Activate the workflow again to resume.

Poll for new leads

If your n8n sits behind a firewall, webhooks can't reach it. Use the Fondaro Polling Trigger instead: it checks for new leads on your schedule and keeps its own place, so none are missed.

Actions

Rules worth knowing:

• Find matches email, phone or external id exactly, among the leads in your CRM. A 404 means no lead matched, not a broken key.
• Create needs a language as a BCP-47 tag (en-GB, es-ES, sv-SE). A missing or unknown one is refused. If you set no assignees, your routing rules assign the lead.
• Deal › Create uses your billing currency; set up Billing first.
• Tags take names or ids. A name that does not exist is created; an id that does not exist is refused and nothing is created. Use ids for anything that must survive a rename or merge. Merging tags in Fondaro sends no per-lead events.
• Add Assignees keeps everyone already assigned and adds the people you send. Send teamIds to add everyone in a team, up to 50 people per lead.
• Semantic Search finds leads whose notes, call transcripts and emails match a description; Match to Listing finds leads whose history fits one listing. Both return up to 30 ranked matches with the evidence, and share a limit of 30 requests a minute.
• Get Calls and Get Activities page with nextOffset until hasMore is false. A call's ownerId is the person who made or took the call, which is not the same as the lead's current assignee; join it to User › Get.
• Viewing › Get Many reads viewings on your own listings, filtered by listing, lead, agent, status or time. It does not create or change viewings.

List leads with filters

Lead › Get Many calls GET /integrations/v1/leads (scope leads:read), newest first:

curl -H "Authorization: Bearer fdr_n8n_..." \  "https://api.fondaro.com/integrations/v1/leads?tags=vip&crmStatus=potential&limit=100"

The response is { leads, total, hasMore }. Every lead carries tags[] and origin: for a lead Fondaro brought you, the ad, the homes and the form answers; otherwise null.

Troubleshooting

Prefer plain HTTP? Every action is a normal REST call; see the Integrations API. Questions: support@fondaro.com.