For AI agents and tools: the complete index of this documentation is at /llms.txt; every page is also available as Markdown by adding .md to its address.

πŸ”Œ

Send responses to a webhook

Updated Oct 26, 2026

A webhook sends each new response to an address you choose, as soon as it arrives. Use it to feed your own system, a script or an automation tool.

The Webhook tab with the URL, secret and steps for validating requests

Set it up

  1. Open the form's Webhook tab.

  2. Paste your Webhook URL.

  3. Click Generate secret and copy it. It is shown once.

  4. Click Send test to see that your endpoint answers.

NoteMaker sends a JSON body with the form, the response and its answers. The tab shows a sample built from your own fields.

Files in the payload

A File upload answer is sent as a list with the file's name, size, type and a signed url. The link works without signing in and expires after a week, so fetch the file soon after the request arrives. The file itself is not in the body.

Check that a request is real

Anyone who knows your URL could send something to it, so verify the signature. Every request carries a header X-Notemaker-Signature: sha256=….

  1. Read the header.

  2. Compute an HMAC-SHA256 of the raw request body with your secret, as hex, and add the sha256= prefix.

  3. Compare the two with a constant-time comparison. If they differ, answer 401 and stop.

  4. Only then read the JSON.

The tab has ready-to-copy receiver code in Node.js, Python and PHP. Answer with a 2xx status within 8 seconds. Anything else counts as a failed delivery.

See what happened

Below the settings, the tab counts deliveries and failures and lists every attempt with its time, status, how long it took and a plain-words reason when it failed. Click Re-send on a row to try again with the same body, using the current URL and secret. A re-sent body keeps its original file links, which still expire a week after the response arrived. Clear log empties the list. The newest 200 are kept, and a red dot on the tab means the last attempt failed.

⚠️

NoteMaker refuses to send to private addresses such as localhost or internal servers. To try it out, use a public test endpoint.

Related

Send responses to a webhook β€” TheNoteMaker Docs