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

  1. Open Integraties in je dashboard, klik op Integratie toevoegen en kies Webhooks.
  2. Vul de URL van je endpoint in. Die moet beginnen met https:// en bereikbaar zijn via internet.
  3. Optioneel: voeg headers toe die je endpoint verwacht, bijvoorbeeld een Authorization-header.
  4. Kies de poll en of je nieuwe antwoorden, gewijzigde antwoorden of allebei wilt versturen, en sla op.
  5. Kopieer het Ondertekeningssecret van de pagina van de integratie en klik op Test versturen.

De payload

json
{
	"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
	}
}
  • event is response.created, response.updated, response.deleted of ping voor Test versturen.
  • Bij response.deleted geeft deletedAt aan wanneer de deelnemer zijn antwoord heeft verwijderd, en bevat answers wat hij had verstuurd. Verwijder het ook uit je eigen gegevens.
  • id is uniek voor elke levering. Gebruik het om een levering te negeren die je al hebt verwerkt.
  • answers bevat elke vraag, op volgorde. text is het antwoord zoals het in je resultaten staat; value is de ruwe waarde, waarvan de vorm afhangt van het vraagtype.

Headers

HeaderWat erin staat
X-StrawPoll-EventDe gebeurtenis, zoals response.created
X-StrawPoll-DeliveryDe id van de levering
X-StrawPoll-TimestampWanneer hij is verstuurd, in Unix-seconden
X-StrawPoll-Signaturesha256= 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:

js
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.