Webhooks

Webhooks let SurveyTale push survey events to any URL you control. They are the foundation for connecting SurveyTale to automation tools such as Zapier, Make, n8n, and ActivePieces, or to your own backend.

Prerequisites

• A SurveyTale workspace with permission to manage integrations.
• An HTTPS endpoint that can receive a POST request.

Create a webhook

1. In SurveyTale, open Workspace Settings -> Integrations -> Webhooks.
2. Click Add Webhook.
3. Enter the destination URL that should receive events.
4. Choose the triggers that should fire the webhook:
   • Response created — fires when a respondent starts a survey.
   • Response updated — fires as a respondent progresses.
   • Response finished — fires when a response is completed.
5. Optionally limit the webhook to specific surveys.
6. Save the webhook.

Payload shape

SurveyTale sends a JSON body. The exact fields depend on the survey, but the envelope looks like this:

{
  "webhookId": "<webhook id>",
  "event": "responseFinished",
  "data": {
    "id": "<response id>",
    "surveyId": "<survey id>",
    "finished": true,
    "data": { "<questionId>": "<answer>" },
    "contact": { "id": "<contact id>" },
    "createdAt": "2026-01-01T00:00:00.000Z"
  }
}

Securing your endpoint

• Always use an HTTPS endpoint.
• Validate that requests are intended for your endpoint (for example, with a hard-to-guess URL path or a shared secret you check on receipt).
• Respond with a 2xx status quickly; do heavy processing asynchronously.

Notes and troubleshooting

• If events stop arriving, confirm the webhook is still saved and the endpoint returns a 2xx status.
• SurveyTale stores the original response in SurveyTale. Webhook deliveries are notifications, not the source of truth.