Integrations
Custom Webhooks
Send feedback events to any HTTP endpoint.
Custom Webhooks
Webhooks let you receive real-time notifications when feedback events occur in Lumifeed.
Setup
- Go to Project Settings → Integrations → Webhooks
- Click + Add Webhook
- Enter your endpoint URL
- Choose which events to receive
- (Optional) Set a secret for signature verification
- Click Save
Events
| Event | Trigger |
|---|---|
feedback.created | New feedback submitted |
feedback.updated | Status or tags changed |
feedback.closed | Feedback marked closed |
roadmap.updated | Roadmap item status changed |
changelog.published | Changelog entry published |
Payload format
{
"event": "feedback.created",
"timestamp": "2025-03-01T12:00:00Z",
"projectId": "proj_abc123",
"data": {
"id": "fb_xyz789",
"message": "The export button doesn't work in Safari",
"type": "bug",
"sentiment": "negative",
"priority": 82,
"userId": "user_123",
"userEmail": "ada@example.com"
}
}Signature verification
Lumifeed signs webhook payloads with HMAC-SHA256 using your secret:
x-lumifeed-signature: sha256=abc123...Verify in Node.js:
import crypto from "crypto"
const signature = req.headers["x-lumifeed-signature"]
const expected = "sha256=" + crypto
.createHmac("sha256", process.env.LUMIFEED_WEBHOOK_SECRET!)
.update(JSON.stringify(req.body))
.digest("hex")
if (signature !== expected) {
return res.status(401).send("Invalid signature")
}Retries
If your endpoint returns a non-2xx status, Lumifeed will retry up to 5 times with exponential backoff (1s, 2s, 4s, 8s, 16s).