Naar de inhoud

Developers

Eén ondertekende webhook. Schone JSON, met je eigen velden als sleutels.

Als een inzending is goedgekeurd, stuurt Vink de data als één JSON-POST naar je endpoint. Je bouwt één ontvanger. Op deze pagina staat alles wat je daarvoor nodig hebt.

Overzicht

Een Integration is een HTTPS-endpoint dat je in Vink toevoegt en aan één of meer formulieren koppelt. Als een inzending van dat formulier wordt goedgekeurd, door een mens of door Auto-Send, stuurt Vink één Delivery naar elke gekoppelde Integration.

De body is de Payload: de waarden van de inzending met de velden van het formulier als sleutels, in een kleine envelope. Elk verzoek is ondertekend, zodat je ontvanger kan controleren dat het van Vink komt.

  • Eén POST per Delivery, Content-Type: application/json
  • Ondertekend met HMAC-SHA256 in de header X-Vink-Signature
  • Ongeveer 8 uur lang opnieuw geprobeerd bij timeouts, 408, 429 en 5xx
  • At-least-once: ontdubbel op delivery_id

Vink leest PDF's, foto's, e-mails, spreadsheets en Word-bestanden met Vertex AI, EU-regio.

Vink aanroepen vanuit je eigen code? De API-referentie beschrijft de publieke API en de API-sleutels.

Bestanden naar binnen krijgen

Bestanden komen vandaag via de app binnen: upload meerdere PDF's, foto's, spreadsheets en Word-bestanden tegelijk, of mail ze in. Geen code? Laat een systeem mailen naar het Intake Address van het formulier. Vink maakt van elke e-mail één of meer inzendingen. Een programma kan PDF's, foto's en e-mails ook via de API insturen: POST /v1/forms/{form_id}/submissions.

Bewaart je organisatie de data in Vink, dan leest een programma de goedgekeurde rijen met GET /v1/forms/{form_id}/data-rows.

Standaard koppelingen

Geen developer? Voor deze vier diensten is er een standaard koppeling. Google Sheets zit in Vink zelf: Vink zet elke goedgekeurde inzending als rijen in een sheet. n8n, Make en Zapier ontvangen de webhook, en daar bouw je de rest van de flow: een bericht aan je team, een boeking in je boekhoudpakket.

Staat je systeem er niet tussen? Dat is geen probleem. De webhook werkt met elk systeem dat een HTTPS-verzoek kan ontvangen. Geen developer? Dan bouwen wij de koppeling.

Google Sheetsingebouwd

Abonnement: een gratis Google-account is genoeg. Je hebt geen ander platform nodig, want de koppeling zit in Vink.

  1. Open in Vink Koppelingen en kies Nieuwe Koppeling. Kies bij Soort de optie Google Sheets. Geef de Koppeling een naam. Een nieuwe sheet krijgt dezelfde naam.
  2. Kies Google-account koppelen en log in bij Google. Vink maakt een nieuwe sheet in je Google Drive. Daarna kom je terug in Vink.
  3. Heb je al een sheet? Kies bij Sheet de optie Sheet die ik al heb en daarna Koppelen en sheet kiezen. Log in bij Google. Kies de spreadsheet in het venster van Google, kies het tabblad en kies Deze sheet gebruiken.
  4. Kies Aan een Formulier koppelen en kies het formulier.
  5. Kies Test versturen om te zien hoe de rijen eruitzien. Testrijen hebben [test] voor de bestandsnaam. Verwijder ze daarna uit de sheet.
  6. Klaar. Elke goedgekeurde inzending van dat formulier komt nu als nieuwe rijen in de sheet.

Lijstvelden: Vink maakt één rij per regel van het eerste lijstveld. De andere waarden van de inzending staan op elke rij. Een inzending zonder regels geeft één rij. Een tweede lijstveld komt als JSON in één cel.

Toegang: Vink kan alleen de sheet openen die Vink zelf maakt, of de sheet die jij kiest in het venster van Google. Je andere bestanden in Google Drive blijven dicht.

Kolommen: eerst submission, dan je velden met hun sleutel als kop, en rechts approved_at, approved_by en delivery_id. Een nieuw veld krijgt een nieuwe kolom vóór approved_at. Verander de koppen niet, want Vink zet elke waarde onder de kolom met dezelfde kop. Kan Vink niet meer in de sheet schrijven? Kies dan Google-account opnieuw koppelen en verstuur de mislukte Delivery opnieuw vanuit de inzending. Een sheet die je al hebt: rij 1 moet je kopregel zijn, of het tabblad moet leeg zijn. Vink zet een waarde alleen onder een kolom waarvan de kop precies de sleutel van het veld is. Ontbrekende kolommen komen rechts erbij. Vink verandert je eigen kolommen nooit. In nieuwe rijen blijven ze leeg, dus een formule daar wordt niet doorgetrokken.

Zo werkt de webhook in n8n, Make en Zapier

Je maakt een ontvangst-URL in het platform. In Vink plak je die in een nieuwe Koppeling, en die Koppeling koppel je aan een formulier. Een test-send laat het platform je velden zien, zodat je ze in de volgende stap kunt gebruiken. Daarna gaat elke goedgekeurde inzending van dat formulier daarheen.

Een test-send heeft "test": true. Zet vóór een stap die echte data wegschrijft een filter dat alleen test = false doorlaat. Dan komen tests nooit in je administratie.

De URL is de sleutel. Deze platforms kunnen de header X-Vink-Signature niet makkelijk controleren, dus iedereen die de URL heeft, kan er data naartoe sturen. Zet de URL niet in mails, tickets of screenshots. Uitgelekt? Maak een nieuwe URL in het platform en plak die in de Koppeling in Vink.

n8nvia webhook

Abonnement: gratis als je n8n zelf host (Community Edition). n8n Cloud is betaald, met een gratis proefperiode.

  1. Maak in n8n een workflow met de node Webhook als trigger. Zet HTTP Method op POST en laat Respond op Immediately staan. Kopieer de Test URL.
  2. Open in Vink Koppelingen en kies Nieuwe Koppeling. Plak de Test URL als Endpoint-URL en kies Koppeling maken. Kies daarna Aan een Formulier koppelen.
  3. Kies in n8n Listen for test event. Kies in Vink Test versturen, kies het formulier en Voorbeeldwaarden. De test verschijnt in n8n, met je waarden onder body.data.
  4. Voeg de volgende nodes toe en wijs de waarden toe.
  5. Publiceer de workflow en kopieer de Production URL. Bewerk de Koppeling in Vink en vervang de Test URL door deze URL. De Test URL werkt alleen zolang n8n op een test wacht.

Lijstvelden: een lijstveld komt binnen als array, met één object per regel. Een node Split Out op die array, bijvoorbeeld body.data.lines, maakt één item per regel.

Extra slot: n8n kan een header controleren. Zet Authentication van de Webhook-node op Header Auth, met een naam en een lange willekeurige waarde. Voeg in Vink dezelfde header toe aan de Koppeling en markeer hem als Geheim.

n8n Cloud en een zelf gehoste n8n werken hier hetzelfde. Een zelf gehoste n8n moet via HTTPS bereikbaar zijn vanaf internet.

Makevia webhookeigen app binnenkort

Eigen app: een Vink-app voor Make komt binnenkort. Tot die tijd werkt de webhook, met de stappen hieronder.

Abonnement: werkt op het gratis abonnement van Make (1.000 credits per maand, 2 actieve scenario's). De Webhooks-app zit in elk abonnement, en een webhook start het scenario meteen.

  1. Maak in Make een scenario. Voeg de app Webhooks toe met de trigger Custom webhook. Kies Add, geef de webhook een naam en sla op. Kopieer het adres dat Make toont.
  2. Open in Vink Koppelingen en kies Nieuwe Koppeling. Plak het adres als Endpoint-URL en kies Koppeling maken. Kies daarna Aan een Formulier koppelen.
  3. Make wacht nu op data. Kies in Vink Test versturen, kies het formulier en Voorbeeldwaarden. Make leert je velden uit deze test.
  4. Voeg de volgende module toe, bijvoorbeeld Google Sheets, en wijs de waarden toe. Ze staan onder data, met je eigen veldsleutels. Zet het scenario aan.
  5. Later de velden van het formulier aangepast? Open de webhook-module, kies Detect new values en stuur nog een test.

Lijstvelden: een lijstveld komt binnen als array, met één object per regel. Wil je elke regel apart verwerken, bijvoorbeeld één spreadsheetregel per factuurregel? Zet dan een Iterator op die array vóór de volgende module.

Extra slot: Make kan een API-sleutel controleren. Voeg er een toe aan de webhook in Make. Voeg in Vink de header x-make-apikey met die sleutel toe aan de Koppeling, en markeer hem als Geheim. Dan is de URL alleen niet meer genoeg.

Make antwoordt meteen met 200 en zet de data in een wachtrij. Is de wachtrij van de webhook vol, dan antwoordt Make 400. Vink markeert de Delivery dan als mislukt, en een Admin kan hem opnieuw versturen vanuit de inzending.

Zapiervia webhookeigen app binnenkort

Eigen app: een Vink-app voor Zapier komt binnenkort. Tot die tijd werkt de webhook, met de stappen hieronder.

Abonnement: je hebt een betaald Zapier-abonnement nodig. Webhooks by Zapier zit niet in het gratis abonnement.

  1. Maak in Zapier een Zap. Kies als trigger Webhooks by Zapier met het event Catch Hook. Kopieer de webhook-URL die Zapier toont.
  2. Open in Vink Koppelingen en kies Nieuwe Koppeling. Plak de URL als Endpoint-URL en kies Koppeling maken. Kies daarna Aan een Formulier koppelen.
  3. Kies in Vink Test versturen, kies het formulier en Voorbeeldwaarden. Kies in Zapier Test trigger en kies het verzoek dat binnenkwam.
  4. Voeg de actie toe, bijvoorbeeld Google Sheets, en wijs de waarden toe uit data. Publiceer de Zap.

Lijstvelden: een lijstveld komt binnen als array van objecten. Zapier toont de regels als line items: een actie die line items ondersteunt, neemt ze allemaal tegelijk. Wil je één actie per regel? Gebruik dan Looping by Zapier.

Slot: een Catch Hook controleert geen headers, dus de geheime URL is het enige slot. Behandel hem als een wachtwoord.

Een Zap die uit staat of verwijderd is, antwoordt na een tijdje 404. Vink markeert de Delivery dan als mislukt. Zet de Zap aan, en een Admin verstuurt de mislukte Delivery opnieuw vanuit de inzending.

Envelope

Dit is een echte Payload van een demoformulier Invoices, met een lijstveld voor de factuurregels. De sleutels onder data zijn je eigen veldsleutels, dus elk formulier heeft zijn eigen vorm.

POSThttps://your-system.example/vink
{
  "event": "submission.approved",
  "delivery_id": "dlv_3f6c2a1e-8b4d-4e2f-9a71-5c0d8e7b2f14",
  "test": false,
  "submission": {
    "id": "k97d4m2x8q1v6c3n5b0e7h9r2t4w8a1f",
    "filename": "invoice-F-2026-0418.pdf",
    "reference": "PO-2026-1042",
    "uploaded_at": "2026-09-30T08:12:04.000Z",
    "file_url": "https://files.vink.page/invoice-F-2026-0418.pdf?X-Amz-Expires=86400&X-Amz-Signature=…"
  },
  "form": {
    "id": "jd72k9m3x5q8v1c4n6b0e3h7r2t9w5as",
    "version": 3
  },
  "approval": {
    "mode": "manual",
    "by": "k1754bq2m9x6c8v3n0b5e7h1r4t2w6yd",
    "at": "2026-09-30T08:14:51.000Z"
  },
  "data": {
    "supplier_name": "Drukkerij Hoekstra B.V.",
    "invoice_number": "F-2026-0418",
    "invoice_date": "2026-09-14",
    "purchase_order": null,
    "total_excl_vat": 1240,
    "vat_amount": 260.4,
    "iban": "NL91ABNA0417164300",
    "paid": false,
    "lines": [
      {
        "description": "Flyers A5, 5,000",
        "quantity": 5000,
        "amount": 740
      },
      {
        "description": "Posters A2, 200",
        "quantity": 200,
        "amount": 500
      }
    ],
    "credit_notes": []
  }
}

Drie regels waar je parser op kan rekenen

  • Elke sleutel is er altijd, ook bij optionele velden.
  • null betekent geen waarde.
  • [] betekent een lijst zonder regels.
SleutelBetekenis
eventAltijd submission.approved.
delivery_idUniek per Delivery. Blijft gelijk als een Delivery opnieuw wordt geprobeerd of opnieuw verstuurd, dus gebruik het om te ontdubbelen.
testtrue bij een test-send, false bij een echte Delivery.
submissionDe inzending: het id, de bestandsnaam en wanneer ze is geüpload (ISO 8601, UTC), en file_url: een link naar het bestand die 24 uur werkt, nieuw bij elke verzending. Haal het bestand binnen die tijd op. Bij een inzending die als e-mail binnenkwam, en bij een test, is het null. En reference: je eigen referentie voor de inzending (een ordernummer, een dossiernummer), meegestuurd als reference via de API of als plus-tag van een intake-adres (adres+po123@…, in kleine letters); null als er geen meekwam.
formHet id van het formulier en de formulierversie waarmee de inzending is gelezen.
approvalmanual of auto (Auto-Send), het id van de gebruiker die goedkeurde (null bij Auto-Send) en wanneer.
dataDe waarden, per veld. Getallen zijn getallen, datums zijn YYYY-MM-DD, ja/nee-velden zijn booleans en lijsten zijn arrays van objecten.

Handtekening controleren

Elk verzoek heeft een header met een tijdstempel en een HMAC-SHA256-handtekening. Elke Integration heeft een eigen secret dat begint met whsec_. Je vindt het bij de Integration in de app.

X-Vink-Signature: t=1790757291,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd

Zo controleer je een verzoek

  1. Splits de header op komma's en lees t (Unix-seconden) en v1 (hex).
  2. Bereken HMAC-SHA256 met je secret over de string {t}.{rawBody}: de tijdstempel, een punt en de ruwe body precies zoals ontvangen.
  3. Vergelijk je uitkomst met v1 met een vergelijking in constante tijd.
  4. Weiger het verzoek als t meer dan 5 minuten van je eigen klok afwijkt. Zo kan een onderschept verzoek niet opnieuw worden afgespeeld.

Gebruik de ruwe bytes van de body. Als je de JSON parset en opnieuw serialiseert, veranderen witruimte en volgorde, en klopt de handtekening niet meer.

Node.js
import crypto from "node:crypto";

const TOLERANCE_SECONDS = 5 * 60;

// rawBody: the request body exactly as received (a Buffer or string),
// before any JSON parsing. With Express: express.raw({ type: "application/json" }).
export function verifyVink(rawBody, header, secret) {
  const parts = Object.fromEntries(
    (header ?? "").split(",").map((part) => part.trim().split("=", 2)),
  );
  const timestamp = Number(parts.t);
  if (!Number.isInteger(timestamp) || !parts.v1) return false;

  const age = Math.abs(Date.now() / 1000 - timestamp);
  if (age > TOLERANCE_SECONDS) return false;

  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${timestamp}.`)
    .update(rawBody)
    .digest();
  const received = Buffer.from(parts.v1, "hex");
  return received.length === expected.length && crypto.timingSafeEqual(received, expected);
}

// if (!verifyVink(req.body, req.get("X-Vink-Signature"), process.env.VINK_SECRET)) {
//   return res.status(401).end();
// }

Bezorging en nieuwe pogingen

Vink wacht maximaal 15 seconden op je antwoord.

Jouw antwoordWat Vink doet
Elke 2xxBezorgd.
Timeout, netwerkfout, 408, 429 of 5xxOpnieuw geprobeerd na ongeveer 1 minuut, 5 minuten, 30 minuten, 2 uur en 6 uur: 6 pogingen in ongeveer 8 uur.
Elke andere 4xxMeteen mislukt. Een Admin kan een mislukte Delivery opnieuw versturen vanuit de app of met de API.

Een Retry-After-header (seconden of een HTTP-datum) wordt gerespecteerd, tot 24 uur.

Redirects worden niet gevolgd. Je endpoint moet HTTPS gebruiken.

Bezorging is at-least-once. Dezelfde Delivery kan twee keer aankomen, bijvoorbeeld als je ontvanger hem opsloeg maar een timeout gaf voordat hij antwoordde. Bewaar delivery_id en sla een Delivery over die je al hebt verwerkt.

Headers

Je kunt eigen headers aan een Integration toevoegen, zoals een API-sleutel of Basic auth. Markeer een header als geheim en de waarde wordt versleuteld opgeslagen en daarna alleen gemaskeerd getoond. Vink zet Content-Type en X-Vink-Signature zelf.

Vink · Inzending · Deliveries
De bezorgstatus van een inzending in Vink, met een nieuwe poging

Test-send

Stuur vanuit een Integration een test naar je endpoint voordat er een echte inzending weggaat. Kies voorbeeldwaarden voor elk veld, of lege waarden zodat je ontvanger null en [] ziet. Je kunt ook een goedgekeurde inzending opnieuw als test versturen.

Een test heeft "test": true, is net zo ondertekend als een echte en is nooit een Delivery: hij wordt niet opnieuw geprobeerd en staat niet in de bezorglog van een inzending. Het antwoord van je endpoint zie je meteen.

Vink · Integrations
Het venster om vanuit een Integration in Vink een test te versturen

Koppelservice

Geen developer? Wij bouwen de koppeling voor je, voor een vaste prijs vanaf € 799. Lees er meer over en vraag hem aan bij de koppelservice.