Teamleader Focus koppelen met je boekhouding, website en planning

Wat je met Teamleader Focus koppelt

• Websiteformulieren als lead of contact in Teamleader, met de juiste herkomst
• Gewonnen deals omzetten naar een factuur of project
• Facturen uit Teamleader naar je boekhouding
• Contacten en bedrijven gelijk houden met je mailinglijst of andere systemen
• Opvolgtaken bij offertes die blijven liggen

Hoe de koppeling werkt

De koppeling logt in via OAuth 2.0 met een integratie die in de Teamleader Marketplace is geregistreerd. Teamleader geeft korte toegangstokens en een refresh-token dat één keer bruikbaar is; de koppeling bewaart steeds het nieuwe. Gebeurtenissen komen binnen via webhooks die de koppeling bij Teamleader registreert; de rest wordt op vaste momenten gecontroleerd. Teamleader begrenst aanroepen per minuut, dus de koppeling werkt in porties.

Feiten over de API van Teamleader Focus

Gecontroleerd op 2 november 2026 tegen de officiële documentatie. Limieten, prijzen en versies veranderen; de bron staat per regel erbij.

Feit	Wat de documentatie zegt	Bron
Authenticatie	OAuth 2.0 authorization-code-flow; een autorisatiecode is eenmalig en tien minuten geldig.	Teamleader: Authentication
Geldigheid token	Toegangstokens hebben een korte levensduur; een refresh-token is één keer bruikbaar en levert een nieuw toegangs- en refresh-token op.	Teamleader: Authentication
Limieten	Een schuivend venster van één minuut (de documentatie noemt 200 per minuut als voorbeeld). Bij overschrijding 429; de headers x-ratelimit-limit, -remaining en -reset zeggen wanneer het weer kan.	Teamleader: General principles
Webhooks	Ja; te registreren via de API op een HTTPS-adres met een lijst van gebeurtenistypen.	Teamleader: Register webhooks
Testomgeving	Niet in de openbaar leesbare documentatie.	Teamleader: Developer
Versie	API v2 op api.focus.teamleader.eu; de documentatie is een webapplicatie die alleen in een browser leesbaar is.	Teamleader: Developer
Kosten API	Niet in de openbaar leesbare documentatie.	Teamleader: Developer
n8n	Geen ingebouwde node; community-nodes op npm (laatste oktober 2026). Ik koppel via de API met een HTTP-stap.	n8n-documentatie

Wat jij nodig hebt

• Een Teamleader-beheerder die een integratie kan registreren of goedkeuren
• Een vaste herkomstwaarde per formulier of bron, zodat elke lead traceerbaar blijft
• Afspraken over hoe een deal een factuur wordt: regels, btw en betaaltermijn
• Toegang tot de boekhouding of mailinglijst aan de andere kant

Waar het vaak misgaat, en hoe ik dat voorkom

• Refresh-token kwijt: een refresh-token werkt één keer. Bewaar je het nieuwe niet, dan is de koppeling uitgelogd. De koppeling slaat het nieuwe token altijd direct op.
• Minuutlimiet: Teamleader telt aanroepen in een schuivend venster van een minuut en geeft daarboven een 429. De koppeling leest de headers en wacht.
• Dubbele contacten: de koppeling zoekt eerst op e-mailadres voordat hij een contact aanmaakt.
• Deal naar factuur: welke regels, btw en betaaltermijn een factuur krijgt, leg ik vooraf vast; een deal heeft die niet altijd.

Uit de praktijk

Een Teamleader-koppeling staat bij mij nog niet als In productie. De aanpak is dezelfde als bij Zoho CRM en HubSpot: één bron voor herkomst en eigenaar, een vaste sleutel per contact, en een melding als een lead nergens aankomt.

Wat het kost

Een koppeling met Teamleader Focus bouw ik als één afgebakend proces voor een vaste prijs, vanaf €750. Onderhoud en bewaking zijn een maandbedrag: n8n-beheer vanaf €250 per maand, serverbeheer €145 per server. In de gratis scan rekenen we jouw proces door. Alle prijzen en wat erin zit →

Wat ik niet doe

• Ik richt Teamleader zelf niet in (pijplijnen, sjablonen, rollen); ik koppel eraan.
• Ik bewaar refresh-tokens alleen in de beveiligde opslag van n8n, nooit in een workflow of logbestand.
• Ik noem geen limieten of kosten die Teamleader niet openbaar publiceert.

Veelgestelde vragen over Teamleader Focus koppelen

Heeft n8n een Teamleader-node?

Niet ingebouwd. Er zijn community-nodes op npm (de laatste van oktober 2026), maar ik koppel via de officiële API met een HTTP-stap in n8n, zodat de koppeling leesbaar en van jou blijft.

Hoeveel aanroepen per minuut staat Teamleader toe?

Teamleader werkt met een schuivend venster van één minuut; de documentatie noemt 200 per minuut als voorbeeld. Daarboven geeft Teamleader een 429 en zeggen de headers wanneer het weer kan.

Hoe werkt de toegang tot de Teamleader API?

Via OAuth 2.0 met een integratie die bij Teamleader is geregistreerd. Toegangstokens zijn kort geldig; het refresh-token is één keer bruikbaar en levert steeds een nieuw paar op.

Kan Teamleader de koppeling zelf een seintje geven?

Ja, met webhooks die de koppeling via de API registreert op de gebeurtenissen die je nodig hebt. Wat niet via een webhook komt, controleert de koppeling op vaste momenten.

Wat gebeurt er als een factuur niet in de boekhouding aankomt?

De factuur gaat naar een wachtrij en je krijgt een storingsmail met het factuurnummer en wat er misging. Tijdelijke fouten worden automatisch opnieuw geprobeerd.