De Pipedrive API: wat kun je ermee bouwen (en waar loop je tegenaan)

Pipedrive heeft een van de toegankelijkere API’s in CRM-land: RESTful, JSON in en uit, degelijke documentatie op developers.pipedrive.com. Vrijwel alles wat je in de interface kunt — deals aanmaken, contacten bijwerken, activiteiten plannen — kan ook programmatisch. Dat maakt het de basis onder elke serieuze koppeling en elke custom app die wij bouwen.

Dit artikel is de gids die wij zelf hadden willen lezen: wat de API kan, wat er met v2 is veranderd, en de drie dingen waar integraties in de praktijk op stuklopen.

Wat kun je met de Pipedrive API?

De gangbare toepassingen die wij bouwen of tegenkomen:

• Koppelingen met je andere systemen — deals synchroniseren met je boekhouding (Exact, Moneybird), leads uit je website-formulieren direct in de pijplijn, facturatie triggeren bij een gewonnen deal.
• Data-verrijking en -hygiëne — organisaties automatisch aanvullen met KvK- of LinkedIn-data, duplicaten opsporen, velden normaliseren.
• Eigen dashboards en rapportage — data ophalen en combineren met bronnen buiten Pipedrive, voor rapportages die de ingebouwde inzichten niet dekken.
• Custom apps in de interface zelf — via app extensions kun je eigen panelen en modals ín Pipedrive tonen, zodat gebruikers je maatwerk niet in een losse tool hoeven te zoeken.

Authenticatie: API-token of OAuth

Er zijn twee smaken, en de keuze is simpel:

• API-token — elke Pipedrive-gebruiker heeft een persoonlijk token (te vinden onder persoonlijke instellingen). Volgens de huidige documentatie stuur je het mee via de x-api-token-header. Prima voor interne scripts en één-op-één-koppelingen binnen je eigen account.
• OAuth 2.0 — verplicht voor apps die je voor meerdere klanten of via de Pipedrive Marketplace aanbiedt. Meer setup (client id/secret, redirect, token-refresh), maar je krijgt er ook ruimere burst-limits voor terug.

Vuistregel: bouw je voor jezelf, gebruik het token. Bouw je voor anderen, ontkom je niet aan OAuth.

API v2: bouw nieuw werk niet meer op v1

Pipedrive heeft de kern van de API herbouwd als API v2 (https://{jouwdomein}.pipedrive.com/api/v2), en die versie is inmiddels de standaard voor de belangrijkste objecten: deals, personen, organisaties, activiteiten, producten, pijplijnen, fases en zoeken. De relevante verschillen met v1:

• Cursor-paginatie in plaats van offset — sneller en betrouwbaarder bij grote datasets (limiet per pagina: maximaal 500 records).
• Strikte types — echte booleans, tijden in RFC 3339-formaat, en custom fields netjes genest in een eigen custom_fields-object in plaats van als losse hash-keys door je payload heen.
• PATCH in plaats van PUT voor updates.
• Lagere tokenkosten — v2-endpoints zijn goedkoper binnen het rate-limitbudget (daarover hieronder meer).

Belangrijk voor bestaande integraties: Pipedrive heeft een flink deel van de v1-endpoints formeel gedeprecieerd, met een aangekondigde einddatum eind 2025 — sindsdien is de beschikbaarheid ervan niet meer gegarandeerd, en platforms als Make en Zapier hebben hun Pipedrive-modules op een harde v2-deadline van 31 juli 2026 gezet. Draait er bij jou nog iets op v1: migreren is geen “ooit”-klus meer. De officiële migratiegids op developers.pipedrive.com beschrijft per endpoint wat er verandert.

Rate limits: het token-budget begrijpen

Dit is de plek waar integraties in de praktijk het vaakst omvallen. Pipedrive hanteert sinds eind 2024 een token-gebaseerd dagbudget per bedrijf:

• Het budget = 30.000 basistokens × een plan-multiplier × het aantal gebruikers. De multiplier loopt van 1 (Lite) via 2 (Growth) en 5 (Premium) naar 7 (Ultimate).
• Elke request kost tokens: een enkel object ophalen is goedkoop (2), een lijst-request kost 20, een update 10 en een zoekopdracht 40.
• Is het budget op, dan krijg je HTTP 429 tot het budget om middernacht (servertijd) reset.
• Daarbovenop gelden burst-limits per 2 seconden, afhankelijk van je plan; OAuth-apps krijgen ruimere limieten dan API-tokens.

De praktische consequenties: synchroniseer incrementeel (alleen gewijzigde records, niet elke nacht de hele database), gebruik v2-endpoints (goedkoper), en vang 429’s netjes af met een retry-strategie. Een koppeling die dit negeert werkt prima in de demo — en valt om zodra het datavolume echt wordt.

Webhooks: laat Pipedrive jou bellen

Voor realtime-integraties wil je geen polling maar webhooks: Pipedrive stuurt een HTTP-call naar jouw endpoint zodra er iets gebeurt. De huidige generatie (v2) werkt met events in het formaat actie.object — bijvoorbeeld create.deal, change.person, delete.activity, of *.* voor alles.

Weet wat het afleveringscontract is: Pipedrive wacht maximaal 10 seconden op antwoord en probeert het bij mislukking drie keer opnieuw met oplopende tussenpozen. Blijft je endpoint falen, dan wordt de webhook tijdelijk geblokkeerd en na drie dagen aanhoudend falen zelfs verwijderd. Bouw je ontvanger dus zo dat hij direct 200 teruggeeft en het werk asynchroon afhandelt — verwerk je de payload synchroon en duurt dat te lang, dan lijkt je integratie te werken totdat hij stilletjes is uitgeschreven.

App extensions: je maatwerk ín Pipedrive

Onderschat instrument: je kunt eigen functionaliteit in de Pipedrive-interface zelf hangen. Van simpele app actions (een link of modal vanuit een deal) tot volledige custom UI-panelen die met de bijbehorende SDK in het deal- of contactscherm renderen. Voor teams betekent dat: geen tabblad-jungle, maar je offertetool, planningsinfo of klantdata gewoon in het scherm waar de verkoper toch al werkt. Pipedrive levert er officiële client-libraries (o.a. Node.js en PHP) en een CLI-scaffolder voor.

Limieten om vooraf te kennen

Twee limieten die je ontwerp beïnvloeden voordat je een regel code schrijft:

• Custom fields zijn plan-gebonden — van enkele tientallen velden op het instapplan tot enkele honderden op de hoogste plannen. Wie elk datapunt een eigen veld geeft, loopt vast; modelleer bewust.
• Paginatie maxt op 500 records per pagina — bulk-migraties en volledige syncs zijn dus altijd meerdere requests, die óók tokens kosten. Plan grote migraties buiten kantoortijden en incrementeel.

Zelf bouwen of laten bouwen?

Een eenvoudige koppeling — formulier naar deal, deal naar factuur — is met de API-docs en een middag concentratie prima zelf te doen. Het wordt een ander verhaal bij twee-weg-synchronisatie, rate-limit-gevoelige volumes of maatwerk in de interface. Dat is precies het werk dat wij dagelijks doen: bekijk onze custom apps-dienst of de koppelingen die we standaard bouwen.

Nog geen Pipedrive-omgeving om tegenaan te ontwikkelen? Start een gratis proefomgeving van 30 dagen — ook voor developers de makkelijkste sandbox.