Webhooks

Subscribe to session events to react to votes in real time — update a leaderboard, trigger a workflow, or pipe responses into your own store.

Register an endpoint

await doppio.webhooks.create({
  url: "https://example.com/doppio",
  events: ["session.started", "response.created", "session.closed"],
});

Event shape

{
  "event": "response.created",
  "sessionId": "QX-42",
  "data": { "optionId": "opt_2", "weight": 1, "at": "2026-06-06T10:14:02Z" }
}

NOTE

Doppio signs every delivery with an X-Doppio-Signature header. Verify it against your endpoint's signing secret to confirm authenticity.