De Realworks-API koppelen: wat je als kantoor zelf regelt

Voordat een softwareleverancier op Realworks mag aansluiten, neemt je kantoor zelf de API af in de Realworks Marketplace en geeft het de relaties vrij die de koppeling mag zien. Daarna bepaalt de API wat er kan: er zijn acht API's, twee daarvan exporteren alleen, en voor de opdracht en de commissie bestaat geen API.

KeyVue koppelt op deze manier aan Realworks: zie wat er meegaat en wat je kantoor zelf doet.

Waarom het kantoor zelf aan zet is

Bij een Realworks-koppeling beslist het kantoor, niet de leverancier, welke gegevens er gedeeld worden. Een ontwikkelaar kan pas koppelen nadat het kantoor de API heeft afgenomen en toegang heeft gegeven.

Dat past bij wie Realworks is. Het pakket is sinds 2015 voor 100% eigendom van de NVM en noemt op de eigen CRM-pagina 2.550 kantoren en 19.000 dagelijkse gebruikers. In onze eigen meting van 23 augustus 2026 laat ruim een kwart van de makelaarswebsites Realworks zien. Het pakket bevat dus het klantdossier van een groot deel van de sector, en de toegang daartoe ligt bij het kantoor dat de gegevens beheert.

Plan daarom interne tijd in bij de start. Die tijd valt bij jou, niet bij de leverancier. Wie die tijd niet inplant, loopt het risico dat de koppeling weken stilligt.

Stap 1: de API afnemen in de Marketplace

De eerste stap is dat iemand met beheerrechten in Realworks de juiste API afneemt in de Realworks Marketplace. Zonder die stap mag geen enkele leverancier aansluiten, hoe ver zijn software ook klaarstaat.

Vraag de leverancier vooraf schriftelijk welke van de acht API's hij nodig heeft. Neem niet meer af dan nodig: elke extra API geeft een extra partij toegang tot een deel van je gegevens.

Leg intern vast wie de API afneemt en wie hem later weer kan opzeggen. Bij een kantoor met meerdere vestigingen is dat niet altijd de persoon die de software uitkoos.

Stap 2: relaties vrijgeven

De tweede stap is het vrijgeven van relaties. Relaties zijn voor een koppeling pas zichtbaar als ze per stuk zijn vrijgegeven. Een afgenomen API betekent dus nog niet dat de leverancier je hele relatiebestand ziet.

Dat is goed voor de privacy en lastig voor de planning. Spreek af:

• welke relaties je vrijgeeft, bijvoorbeeld alle verkopers en zoekers, of alleen een deel;
• wie dat doet, per vestiging of centraal;
• hoe je omgaat met relaties die er later bij komen.

Controleer na de eerste synchronisatie of het aantal relaties in de koppeling overeenkomt met wat je verwachtte. Een groot verschil wijst vaak op de vrijgave, niet op een fout in de software.

Wat de acht API's uitwisselen

Realworks heeft acht API's, elk voor een eigen deel van het dossier. De tabel geeft per API weer wat er volgens de eigen API-pagina's van Realworks in zit (september 2026). Waar de richting daar niet duidelijk uit bleek, staat dat erbij.

Leads importeren via Wonen of Business is een standaardvoorziening. Dat een leverancier leads in Realworks kan zetten, is dus geen onderscheid; de vraag is wat hij er nog meer mee doet.

De nieuwsbrief-opt-in in de Relatie-API is sinds 1 september 2025 extra relevant. Realworks stopte toen met de eigen nieuwsbriefmodule, en een extern platform heeft die opt-in nodig om te weten wie je mag mailen. De opties staan in de Realworks-nieuwsbrief is gestopt.

Wat alleen exporteert

Taken en Facturen zijn alleen te exporteren. Een koppeling kan die gegevens uit Realworks lezen, maar er via deze API's niets in terugzetten.

Belooft een leverancier dat hij taken of facturen in Realworks aanmaakt, vraag dan hoe. Het antwoord kan kloppen via een andere route, maar niet via deze twee API's.

Waar geen API voor is

Voor de opdracht en de commissie heeft Realworks geen API. Een koppeling kan dus niet uitlezen welke verkoopopdracht er is getekend of wat die opbracht.

Dat heeft een direct gevolg voor rapportage. De vraag welke leadbron een opdracht opleverde, is niet te beantwoorden door alleen Realworks uit te lezen. De opdracht moet ergens anders aan de lead en de bron worden gekoppeld. Hoe je die registratie inricht, staat in welke leadbron levert opdrachten op, en wat je er per kwartaal mee doet in het kwartaaloverzicht voor meerdere vestigingen.

Vragen voor een leverancier voordat je koppelt

Stel een leverancier deze vragen voordat je in de Marketplace iets afneemt. De antwoorden bepalen wat je kantoor moet regelen en wat je van de koppeling kunt verwachten.

Wil je leveranciers naast elkaar leggen, dan helpt het overzicht van soorten leadsoftware. Voeg je na een overname twee kantoren samen, lees dan ook de eerste honderd dagen van een integratie.

KeyVue synchroniseert relaties en aanbod uit Realworks en rapporteert conversie per bron, vestiging en makelaar, inclusief de commissie op doorverwijzingen. Vraag in een demo welke API's daarvoor nodig zijn en hoe de opdracht aan de lead wordt gekoppeld.

Veelgestelde vragen