De Pipelien API

De API (v1) draait om je leads. Je leest en synchroniseert ze incrementeel (alleen wat er veranderd is sinds je laatste run), ziet per lead waar de offerte staat (verstuurd, bekeken, ondertekend) met een link naar de offerte op Pipelien, en leest je productcatalogus uit. Alle endpoints leveren JSON met cursor-paginering, onder één vaste basis: https://app.pipelien.com/api/v1.

v1 is bewust read-only en minimaal. De resources zijn: me (controleer je sleutel en scopes), leads (lijst en per stuk, inclusief offertestatus) en products (catalogus, alleen ter identificatie). Wil je niet elke minuut opnieuw ophalen, dan luister je met een webhook; dat staat in een eigen artikel. Data terugschrijven staat op de roadmap en komt er later bovenop, dus wat je nu bouwt blijft werken.

Elke request authenticeer je met een API-sleutel als bearer token in de Authorization-header. Sleutels maak je zelf aan onder Beheer, Koppelingen, tabblad API, met Sleutel aanmaken. Je geeft de sleutel een label en vinkt aan welke scopes hij krijgt. De sleutel (pk_live_...) zie je één keer, direct na het aanmaken: bewaar hem in een secret manager, nooit in client-side code of een publieke repo.

Een sleutel hoort bij één organisatie en krijgt de scopes die je aanvinkt: leads:read, proposals:read, proposals:access_code en products:read. Die laatste geeft de toegangscode van een verstuurde offerte, waarmee je het klantdocument rechtstreeks opent, en zit daarom niet in proposals:read: vink hem alleen aan als je koppeling hem echt nodig heeft. In de lijst zie je per sleutel wie hem maakte, hoeveel calls hij deed, wanneer hij voor het laatst gebruikt is en welk rate limit hij heeft (standaard 120 requests per minuut). Lekt een sleutel, dan blokkeer je hem op diezelfde plek. Dat werkt direct en kan niet ongedaan worden gemaakt, dus alles wat er nog mee belt stopt op datzelfde moment met werken.

Je eerste call is altijd deze: curl https://app.pipelien.com/api/v1/me -H "Authorization: Bearer pk_live_your_key_here". Het antwoord bevestigt dat je sleutel werkt, voor welke organisatie, met welke scopes en welk rate limit.

Dit artikel is een overzicht. De volledige API-referentie met live codevoorbeelden (curl, JavaScript, Python, PHP, Ruby en Go) en een testconsole vind je in de app onder Beheer, Koppelingen, tabblad API. Daar staan alle endpoints, parameters, velden, foutcodes, paginering en het incrementele-syncpatroon uitgewerkt.

API-toegang wordt per organisatie geactiveerd. Meldt het tabblad API dat de developer-API niet is ingeschakeld voor je organisatie, dan zetten wij hem voor je aan.