TelMaar koppelen aan een ander systeem: API-sleutels, webhooks en agenda

Wil je TelMaar aan een ander systeem knopen, dan moet dat veilig en gericht: een koppeling hoort alleen bij het bedrijf waarvoor hij bedoeld is, en andere systemen willen weten wanneer er iets gebeurt zonder er steeds naar te vragen.

Sleutels, scopes en webhooks

Een API-sleutel hoort bij één onderneming en krijgt scopes: de rechten die bepalen waar hij wel en niet bij mag. Een webhook is een adres van een ander systeem dat TelMaar aanroept bij een gebeurtenis, zoals een afgeronde klus of een verstuurde factuur. Lukt dat de eerste keer niet, dan wordt de melding opnieuw aangeboden.

Zo maak je een koppeling

  1. 1Ga naar Instellingen en kies API en webhooks; dit vraagt de rol met beveiligingsrechten.
  2. 2Klik op Nieuwe sleutel, kies de scopes en kopieer de sleutel meteen: hij wordt maar één keer getoond.
  3. 3Voeg een webhook toe met het adres van het andere systeem en de gebeurtenissen waarop hij moet vuren.
  4. 4Test de webhook; onder Afleveringen zie je per poging of hij aankwam.

Andere koppelingen

  • Agenda: abonneer je per gebruiker op een ICS-agenda en trek de link weer in als het nodig is.
  • Artikelimport uit 2BA: haal artikelgegevens binnen zonder dat je eigen verkoopprijs wordt overschreven; dit is eenrichting.
  • Bank, e-factuur (UBL) en het XAF-auditfile staan op de pagina Integraties beschreven.
Onder Beveiliging in de instellingen vind je ook API en webhooks en de actieve sessies.

Laatst nagelopen op 5 september 2026

Lees ook

Niet gevonden wat je zocht?

Stuur ons je vraag. Tijdens je proefperiode helpen we gratis mee, ook met overstappen.

Stel je vraag
Terug naar Aan de slag