Nudge API
Versie 2026-10-22 · vanaf Starter · voor Zapier, Make en eigen koppelingen
Met de Nudge API haal je leads en Nudges op en laat je Nudge een bericht sturen zodra er iets gebeurt: een nieuwe lead, een afspraak, een reactie op een opvolgmail of een gewonnen deal. Zo koppel je Nudge aan je CRM, je administratie of een eigen systeem. Gebruik je Zapier of Make, dan hoef je hier niets van te weten: de Nudge-app regelt het.
De API, de apps voor Zapier en Make en de eigen webhook horen bij Starter en hoger. Liever zonder API? Elke organisatie op Starter of hoger heeft ook een eigen webhook in Instellingen → Integraties, met dezelfde berichten.
1. Een sleutel maken
Ga in Nudge naar Instellingen → Integraties → API-sleutels en maak een sleutel. Je ziet hem één keer; bewaar hem veilig en plak hem nooit in een chat of e-mail. Alleen de eigenaar of een beheerder kan sleutels maken en intrekken.
Stuur de sleutel mee in elke aanvraag:
Authorization: Bearer nk_live_…
Basisadres: https://app.nudgedigital.nl/api/v1. Limiet per minuut voor je hele organisatie: Starter 60,
Growth 120, Scale 300, Agency 600 (en hooguit 120 per sleutel). Daarboven krijg je 429.
2. Beveiliging
- Een sleutel geeft alleen toegang tot de gegevens van je eigen organisatie. We bewaren hem niet zelf, alleen een versleutelde afdruk.
- Haal je iemand uit je team, of is hij geen beheerder meer, dan worden de sleutels die hij maakte direct ingetrokken. Ook Zapier- en Make-koppelingen op die sleutels stoppen.
- Bij elke sleutel zie je wanneer hij gebruikt is en voor welk endpoint, met het begin van een versleuteld IP-adres. Zo zie je meteen als er iets vreemds gebeurt.
- Webhooks gaan alleen naar publieke https-adressen. Het adres wordt bij elke verzending opnieuw gecontroleerd, ook op het moment van verbinden.
- Ga je terug naar Free, dan stoppen de API, de webhooks en de koppelingen tot je weer een pakket kiest.
3. Endpoints
GET /me: van welke organisatie de sleutel is. Handig als verbindingstest.-
GET /leads?limit=25&since=2026-10-01T00:00:00Z&widget_id=…: leads, nieuwste eerst, maximaal 100 per keer. Leads boven de maandlimiet van je pakket komen mee zonder contactgegevens ("locked": true), net als in je Lead Vault. GET /widgets: je Nudges, met id, naam en status.-
GET /hooks,POST /hooks,DELETE /hooks/{id}: webhook-abonnementen, zie hieronder.
Een lead ziet er zo uit:
{
"id": "6d1c…",
"name": "Sanne de Vries",
"email": "sanne@example.com",
"phone": "+31612345678",
"company": "Example B.V.",
"score": 82,
"tier": "hot",
"status": "new",
"dealValue": null,
"widgetId": "a41f…",
"widgetName": "Growth scan",
"sourceUrl": "https://example.com/pricing?utm_source=google",
"answers": [{ "questionId": "q1", "label": "Biggest challenge?", "value": "Not enough time" }],
"locked": false,
"leadCreatedAt": "2026-10-22T09:14:03.000Z"
}
4. Webhook-abonnementen
Laat Nudge een bericht sturen zodra er iets gebeurt. Een abonnement maak je met:
POST /api/v1/hooks
{ "url": "https://your-system.com/nudge", "event": "lead.new" }
→ 201 { "ok": true, "id": "…", "event": "lead.new", "secret": "nwh_…" }
Gebeurtenissen: lead.new, lead.status_changed (met
dealwaarde bij gewonnen), lead.replied,
meeting.scheduled en meeting.cancelled. Bij een nieuwe
lead staat het lead-id in id, bij de andere gebeurtenissen in
leadId. Maximaal 25 abonnementen per organisatie.
Elk bericht is JSON met event, eventId en
createdAt, en is ondertekend met het geheim van het abonnement:
X-Nudge-Signature: t=1761124443,v1=5f2b…
// v1 = HMAC-SHA256(secret, `${t}.${body}`) in hex. Weiger berichten ouder dan 5 minuten.
Antwoord met een 2xx-code. Lukt dat niet, dan probeert Nudge het opnieuw na ongeveer 1, 5 en 30 minuten. Antwoord je met
410 Gone, dan heft Nudge het abonnement op.
5. Fouten
400: ongeldige invoer; de melding zegt wat er mis is.401: geen, een onbekende of een ingetrokken sleutel.403: je pakket heeft geen API-toegang (Free).404: niet gevonden, of niet van jouw organisatie.409: limiet bereikt (sleutels of abonnementen).429: te veel aanvragen; wacht een minuut.
Elke fout is JSON: { "ok": false, "error": "…" }, met een Engelse melding.
Elke response heeft de kop Nudge-Api-Version.
6. Privacy
Via de API haal je persoonsgegevens van leads op. Jij bent daarvoor verantwoordelijk, ook in het systeem waar je ze naartoe stuurt. Zapier, Make of je eigen systeem zijn geen subverwerkers van Nudge maar koppelingen die je zelf kiest; zie de verwerkersovereenkomst en de subverwerkers.
Vragen of een koppeling bouwen voor je klanten? Mail info@nudgedigital.nl.
7. Nudge in je AI-assistent (MCP)
Vraag Claude, ChatGPT of Cursor gewoon: "Welke hete leads kwamen deze week binnen?" of "Waar haken bezoekers af in mijn scan?". Voeg dit adres toe als connector (MCP):
https://app.nudgedigital.nl/api/mcp
- Je logt in met je Nudge-account en kiest welk account de assistent mag zien. Geen sleutel kopiëren.
- Bekijken: Nudges, cijfers per vraag, leads en hun antwoorden.
- Bouwen: vraag "Bouw een scan voor mijn site" en de assistent zet een concept-Nudge klaar. Bezoekers zien dat pas als jij het in de builder bekijkt en live zet. Verwijderen, versturen of iets wijzigen wat al live staat kan de assistent niet.
-
Werkt de app niet met inloggen, zoals Claude Code? Stuur dan een API-sleutel mee:
Authorization: Bearer nk_live_…. - Ontkoppelen kan altijd onder Instellingen → Integraties. Vanaf het Starter-pakket, voor eigenaars en beheerders.