LeadForge kun je op vier manieren vanuit je eigen systemen gebruiken. Met de REST API haal je gegevens op en zet je een antwoord klaar. Webhooks sturen gebeurtenissen meteen naar je eigen adres. Met een MCP-server bevraag je LeadForge vanuit een AI-tool. De scripts zet je op je eigen website.
- REST API API De REST API v1: basisadres, je eerste aanroep en de opbouw van antwoorden.
- Webhooks Gebeurtenissen uit LeadForge meteen doorsturen naar je CRM, Zapier of Make.
- MCP-servers MCP Je klantdata, gedragsmeting en vakkennis bevragen vanuit Claude, Cursor of een andere AI-tool.
- De widget op je site zetten De code van de agent op je site plaatsen in HTML, WordPress, Shopify of Tag Manager.
REST API v1
De REST API is bedoeld voor verkeer van server naar server. Elk adres begint met https://leadforge.nl/api/v1 en vraagt een API-sleutel van één werkruimte. Er zijn tien adressen: negen om te lezen en één om een antwoord in een LinkedIn-gesprek klaar te zetten.
GET https://leadforge.nl/api/v1/me
Vraagt read
GET https://leadforge.nl/api/v1/conversations
Vraagt read
POST https://leadforge.nl/api/v1/conversations/{id}/reply
Vraagt write
GET https://leadforge.nl/api/v1/campaigns
Vraagt read
GET https://leadforge.nl/api/v1/content-gaps
Vraagt read
Begin bij REST API voor je eerste aanroep, en lees daarna Authenticatie, Fouten, Limieten en Paginering en filters.
Webhooks
Een webhook stuurt een gebeurtenis uit LeadForge meteen door naar een https-adres van jou, bijvoorbeeld van je CRM, Zapier of Make. Je kiest per adres uit vijf gebeurtenissen:
lead.created: er komt een prospect met een LinkedIn-profiel bij.conversation.new_message: een prospect stuurt je een bericht op LinkedIn.conversation.reply_sent: er gaat een antwoord uit, door jou, de AI of de API.conversation.label_changed: een gesprek krijgt een ander label.meeting.booked: een gesprek is op Afspraak gezet.
Elke aflevering is ondertekend. Zie Webhooks, Gebeurtenissen en Handtekening controleren.
MCP-servers
Met een MCP-server stel je vragen over je klanten in gewone taal vanuit Claude, Cursor of een andere AI-tool die MCP over HTTP spreekt. De servers staan op https://api.leadforge.nl en werken met een eigen MCP-sleutel, los van de API-sleutel.
- Klanten: lijst, context, prestaties, signalen en aanbevelingen per klant.
- Websites: paginagroepen, doelen, cijfers, wrijving en formulieren uit de eigen gedragsmeting.
- Kennisbank: zoeken in de gedeelde vakkennis over Google Ads, zonder klantdata.
Lees eerst MCP-servers en Koppelen in je AI-tool.
Scripts op je site
Voor je eigen website zijn er drie scripts:
- De widget: de chat-agent van je site, met één regel code.
- De banner: een balk met een vraagveld die de chat opent.
- De meettag: stuurt bezoeken en herkenning naar LeadForge.
De embedcodes van je agents haal je ook op met GET /api/v1/agents.
Wat er niet is
Er zijn geen SDK's en er is geen OpenAPI-bestand om te downloaden. Je roept de API aan met gewone HTTP-verzoeken, zoals in de voorbeelden in deze documentatie.