Signed webhooks
Send Rectify events to your own server, check each request's signature, and handle retries, tests and secret rotation.
POST requests.POST request from Rectify each time an event you picked happens, such as new feedback or a contact entering a segment. Every request is signed, so your server can check it came from Rectify.

whsec_ and is shown only this once. A project can have up to 10 endpoints.contact.identified fires once, the first time a visitor is identified.form.submitted covers forms on your own site, not the widget's forms. It never includes what people typed.help.search_no_results fires at most once a day for the same search.POST with a JSON body:{
"id": "evt_6a1f2c3d4e5f6a7b8c9d0e1f",
"type": "feedback.created",
"occurredAt": "2026-10-27T09:15:00.000Z",
"projectId": "6addf8c8f1748a2b2950c3f4",
"data": {
"feedbackId": "6a1f2c3d4e5f6a7b8c9d0e20",
"type": "bug",
"title": "Export button does nothing",
"priority": "high",
"status": "open",
"pageUrl": "https://acme.example/reports",
"reporter": { "name": "Jane Doe", "email": "[email protected]" },
"url": "https://app.rectify.so/projects/acme-app/feedback/6a1f2c3d4e5f6a7b8c9d0e20"
}
}id is the same for every endpoint that gets the event. Use it, or X-Rectify-Delivery, to skip events you've already handled.HMAC_SHA256(secret, X-Rectify-Timestamp + "." + raw_body)import crypto from 'node:crypto';
import express from 'express';
const app = express();
app.post('/hooks/rectify', express.raw({ type: 'application/json' }), (req, res) => {
const timestamp = req.get('X-Rectify-Timestamp') ?? '';
const signature = req.get('X-Rectify-Signature') ?? '';
const expected = crypto
.createHmac('sha256', process.env.RECTIFY_WEBHOOK_SECRET)
.update(`${timestamp}.${req.body.toString('utf8')}`)
.digest('hex');
const valid = signature.length === expected.length
&& crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
const fresh = Math.abs(Date.now() - Number(timestamp)) < 5 * 60 * 1000;
if (!valid || !fresh) return res.status(401).end();
const event = JSON.parse(req.body.toString('utf8'));
res.status(200).end();
handleEvent(event);
});2xx status counts as delivered.3xx counts as a failure.2xx as soon as you've checked the signature, and do the slow work afterwards.id is evt_test, it has "test": true, and its data holds sample values.localhost or 10.0.0.1, are rejected. So are addresses that resolve to them.2xx status.The signature never matches
whsec_, as the key.My endpoint shows Paused
I get "Webhook URLs must use HTTPS" or "That address is not reachable from webhooks"
I get "At most 10 endpoints per project"
Was this helpful?
Your feedback shapes what we write next.
Related articles
Use the Automation page
Score your leads, post contact activity to Slack and send events to your own systems with signed webhooks.
Set up alerting
Send monitor alerts to email, Slack, Discord, Teams, PagerDuty, a webhook, push, SMS or a phone call, and escalate when nobody answers.
Connect Zapier or Pabbly Connect
Start a Zap or a Pabbly Connect workflow from every new feedback report, and pass it on to thousands of other apps.
Send server events
Record signups, payments and other events from your backend, and see them on the right contact next to what they did in the browser.