Developers
Antwoorden naar je eigen server sturen met webhooks
Ontvang elk antwoord als ondertekende JSON-payload, en controleer of het echt van StrawPoll komt.
Laatst bijgewerkt
Een webhook stuurt elk antwoord naar een adres op je eigen server, als POST-verzoek met een JSON-body.
Instellen
- Open Integraties in je dashboard, klik op Integratie toevoegen en kies Webhooks.
- Vul de URL van je endpoint in. Die moet beginnen met
https://en bereikbaar zijn via internet. - Optioneel: voeg headers toe die je endpoint verwacht, bijvoorbeeld een
Authorization-header. - Kies de poll en of je nieuwe antwoorden, gewijzigde antwoorden of allebei wilt versturen, en sla op.
- Kopieer het Ondertekeningssecret van de pagina van de integratie en klik op Test versturen.
De payload
{
"id": "0193f1c2-…",
"event": "response.created",
"createdAt": "2026-11-08T14:05:12.000Z",
"form": {
"id": "…",
"slug": "team-lunch",
"name": "Team lunch",
"title": "Where should we eat on Friday?",
"url": "https://strawpoll.com/…"
},
"response": {
"id": "…",
"createdAt": "2026-11-08T14:05:11.000Z",
"updatedAt": null,
"deletedAt": null,
"respondent": { "name": "Sam", "email": "sam@example.com", "phone": null },
"answers": [
{
"fieldId": "…",
"question": "Q1 · Where should we eat?",
"value": "…",
"text": "Pizza"
}
],
"comment": null
}
}eventisresponse.created,response.updated,response.deletedofpingvoor Test versturen.- Bij
response.deletedgeeftdeletedAtaan wanneer de deelnemer zijn antwoord heeft verwijderd, en bevatanswerswat hij had verstuurd. Verwijder het ook uit je eigen gegevens. idis uniek voor elke levering. Gebruik het om een levering te negeren die je al hebt verwerkt.answersbevat elke vraag, op volgorde.textis het antwoord zoals het in je resultaten staat;valueis de ruwe waarde, waarvan de vorm afhangt van het vraagtype.
Headers
| Header | Wat erin staat |
|---|---|
X-StrawPoll-Event | De gebeurtenis, zoals response.created |
X-StrawPoll-Delivery | De id van de levering |
X-StrawPoll-Timestamp | Wanneer hij is verstuurd, in Unix-seconden |
X-StrawPoll-Signature | sha256= en de handtekening |
Controleer de handtekening
De handtekening is een HMAC-SHA256, gemaakt met je ondertekeningsgeheim, van de leverings-ID, de tijdstempel en de ruwe request-body, aan elkaar gezet met punten. Bereken hem zelf en vergelijk:
import { createHmac, timingSafeEqual } from 'node:crypto';
function isFromStrawPoll(request, rawBody, secret) {
const id = request.headers['x-strawpoll-delivery'];
const timestamp = request.headers['x-strawpoll-timestamp'];
const signature = request.headers['x-strawpoll-signature'] ?? '';
const expected =
'sha256=' + createHmac('sha256', secret).update(`${id}.${timestamp}.${rawBody}`).digest('hex');
const fresh = Math.abs(Date.now() / 1000 - Number(timestamp)) < 300;
return (
fresh &&
signature.length === expected.length &&
timingSafeEqual(Buffer.from(signature), Buffer.from(expected))
);
}Onderteken de body precies zoals hij binnenkwam, voordat je hem parset. Door oude tijdstempels te weigeren, voorkom je dat iemand een onderschept verzoek opnieuw afspeelt.
Is je geheim misschien uitgelekt, klik dan op Vernieuwen op de pagina van de integratie. Het oude geheim werkt meteen niet meer, dus werk je endpoint bij.
Antwoord op tijd
Antwoord binnen 10 seconden met een willekeurige 2xx-status. Doe traag werk pas nadat je hebt geantwoord.
Mislukt een levering, dan probeert StrawPoll het in de halve minuut daarna nog drie keer, met dezelfde id. Een 4xx-antwoord anders dan 429 wordt niet opnieuw geprobeerd, en redirects worden nooit gevolgd. Elke poging verschijnt onder Recente leveringen, met wat je server antwoordde.