De REST-API en webhooks van Notto

Koppel je eigen software aan Notto. Lees en maak contacten, facturen, inkoopfacturen en betalingen via de API. Krijg een ondertekend bericht als er iets gebeurt.

  • OpenAPI-beschrijving
  • Ondertekende webhooks
  • Sleutels met eigen rechten
01

Sleutels met de rechten die jij kiest

Een eigenaar of beheerder maakt onder Instellingen, Koppelingen een API-sleutel: alleen lezen, voorbereiden of volledig. De sleutel zie je één keer. Wat hij doet staat onder AI-acties. Daar draai je het ook terug.

02

Wat de API doet

Contacten zoeken en aanmaken. Facturen en creditfacturen opvragen, ook één factuur met al zijn regels. Conceptfacturen maken. Inkoopfacturen opvragen en insturen. Betalingen registreren.

Alles staat beschreven in een OpenAPI-bestand, zodat je een client kunt genereren of de API in Postman kunt laden.

03

Webhooks

Een https-adres krijgt een POST op de gebeurtenissen die je kiest: Factuur betaald, factuur verstuurd, factuur te laat, betaling ontvangen, offerte geaccepteerd of afgewezen, klant bekijkt een document, nieuw contact, nieuw of gesloten ticket, formulier ingevuld en nieuwe afspraak.

Elk bericht heeft een eigen id en een Notto-Signature, een HMAC-SHA256 met het geheim van de webhook. Lukt het niet, dan probeert Notto het na een minuut, na tien minuten en na een uur opnieuw.

Wat dit niet doet.

Elke functiepagina hier eindigt met wat er ontbreekt. Je komt er toch achter, en liever nu dan nadat je je administratie hebt overgezet.

  • Een factuur definitief maken of versturen kan niet via de API. Dat doe je in Notto, of via je AI-assistent met jouw akkoord.
  • Offertes, producten en projecten zitten nog niet in de API.
  • In bèta. Tot 1200 verzoeken per minuut.

Veelgestelde vragen

Staat je vraag er niet bij? Stel hem, dan komt het antwoord hier te staan.

Waar staat de documentatie?

Op app.notto.nl/developers, ook zonder account. Met voorbeelden per endpoint en de beschrijving van de webhooks.

Kan ik een sleutel intrekken?

Ja, onder Instellingen, Koppelingen. Hij werkt dan meteen niet meer.

Verder lezen

Klaar met overtypen?

Maak een gratis account en stuur vandaag je eerste factuur. Gratis voor altijd, tot 5 facturen per maand. Meer nodig? Dan kies je later een pakket.

Gratis account aanmakenGratis voor altijd. Geen creditcard nodig.