Skip to main content

Receive Typeform responses

Guides

Typeform signs each webhook with a secret you choose. Receive a webhook from any system covers the shared settings.

Set up​

  1. In Manage Account > Webhooks, select New webhook, enter a name and set Signature to Typeform. Leave Signing secret blank to generate one, or enter your own.
  2. Press Create webhook and copy the webhook URL and the secret.
  3. Add a webhook to the form in Typeform with the webhook URL.
  4. Set the webhook's secret to the same value, through the Typeform Webhooks API secret setting.

DataLug checks the Typeform-Signature header, a SHA-256 HMAC of the body in Base64. The signature has no timestamp, so the response token below is what stops a resent request running twice.

What arrives​

One row per response, as Typeform sends it: event_id, event_type and a form_response object with the answers, hidden fields, definition and the response token.

Duplicates and responses​

The response token, form_response.token, is the event id: a response that arrives twice runs once. Every accepted request is answered 200.