Register a signed webhook on a survey

Deliver a survey's responses to an https endpoint. Every delivery carries an HMAC X-Zigpoll-Signature header formatted t=<unix ms>,v1=<hex>, where v1 is HMAC-SHA256 over <t>.<raw request body>. Delivery is at-least-once and retried on failure, so dedupe on X-Zigpoll-Delivery-Id.

Returns the account's signing secret ONCE, in this response. No other call returns it — store it when you create the webhook.

Endpoints must be public https URLs; localhost, internal hosts and IP literals are rejected. Maximum 20 per survey. Requires admin access.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

The ID of the poll whose responses to deliver.

string
required

The https URL to POST each delivery to.

string
enum
Defaults to always

always delivers on every submission, including from respondents who abandon the survey partway. strict delivers only once a respondent finishes.

Allowed:
Responses

403

Your role does not permit this action, or the account lacks API access

404

Poll not found or you do not own the account it belongs to

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json