Team Webhook Export
Table of Contents
Feedbucket can integrate with your custom solution thanks to team webhooks, with which you can send POST requests to a URL of your choice in five different circumstances: when feedback is submitted, when a comment is added, when feedback is updated, when a comment is updated, and when a comment is deleted.
Configure the team webhook
In order to add and manage the team's webhooks, you will need to follow these steps in Feedbucket Admin:
- Click on the profile icon with your initials in the upper right.
- Select Team Settings.
- Click on Webhooks on the left side menu.
You will be taken to this page:

Click then on Add webhook, and you will see a pop-up where you can enter the following information:
- The URL endpoint of your choice (we will use webhook.site for our example payloads.)
- The events that have to be synced.
- If the webhooks should be sent for all of your projects or the ones of your choice (you must toggle the option off to see individual projects to choose from).

When you confirm and add the webhook, a webhook created popup appears with the signing secret. Copy it now and store it with the endpoint. You can reveal it again later from the webhook settings.

Each webhook has its own signing secret, starting with whsec_ . Existing webhooks already have one. To reveal, copy, or rotate it later, click the pencil icon on the webhook and use the Signing secret field.
Verify webhook signatures
Every team webhook request is signed so you can confirm it came from Feedbucket. We send a Feedbucket-Signature header on each delivery. The value is an HMAC-SHA256 of the raw request body, keyed with that webhook’s signing secret. It looks like this:
Feedbucket-Signature: sha256=206b87e2761edbffce39314900d36e450223a17cf1dd73806a6591c1620cd41a
Important: hash the body exactly as received. Do not pretty-print it, and do not JSON-decode and re-encode it first. If the bytes you hash are not the bytes we sent, verification will fail. PHP’s json_encode() escapes slashes, so URLs in the body look like https:\\/\\/..., not https://....
PHP
$secret = 'whsec_...'; // the signing secret for this webhook
$signature = $_SERVER['HTTP_FEEDBUCKET_SIGNATURE'] ?? '';
$rawBody = file_get_contents('php://input');
$expected = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
if (! hash_equals($expected, $signature)) {
http_response_code(401);
exit('Invalid signature');
}
Node.js
const crypto = require('crypto')
const secret = 'whsec_...' // the signing secret for this webhook
const signature = req.headers['feedbucket-signature']
const rawBody = req.rawBody // the unparsed request body as a string
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(rawBody).digest('hex')
if (expected !== signature) {
res.status(401).send('Invalid signature')
return
}
In Node, make sure you keep the raw body. If a JSON parser runs first, you no longer have the bytes we signed.
Reveal or rotate the secret
In Team Settings → Webhooks, edit the webhook. The Signing secret field is masked until you click Reveal. Use Copy to copy it.


Rotate secret creates a new secret immediately. The next delivery is signed with the new one, and the old one stops working at once. Update your endpoint before you rotate.

After rotating, a Signing secret rotated pop-up will appear with the new secret that you can copy straight away.
How to use the team webhook
We have seen that it's possible to sync five different event types, and we will now list all of them with individual example payloads. Once you have defined the URL endpoint and saved the configuration, you will start receiving those webhooks as soon as the synced event is triggered.
When new feedback is created
Whenever a new piece of feedback is submitted in Feedbucket, the payload in JSON format will be sent to your URL endpoint. Here is how a payload for this type of event will look like:
{
"event": "feedback.created",
"data": {
"id": 975,
"project": {
"id": 98,
"key": "BGwnFKxEbvtHN5H4qaKd",
"name": "Feedbucket Staging",
"url": "https://myclientwebsite.com/demo/hG7LqNp43JlCLdS8ljNj",
"teamId": 100,
"createdAt": "2026-06-01T11:48:44+02:00"
},
"type": "screenshot",
"reporter": {
"type": "member",
"id": 105,
"name": "Elia Niccolini",
"email": "elia@feedbucket.app"
},
"resource": "https://d1amaofjw3j1p2.cloudfront.net/images/ebwmDYOFbMfxW58KnwsMqi6lYjDv4j43x6QrvrCi.jpeg",
"title": "Change this image",
"tags": null,
"attachments": [],
"metaData": {},
"membersOnly": false,
"description": "Create a better image for this feedback",
"sessionDetails": {
"page": "https://myclientwebsite.com/demo/hG7LqNp43JlCLdS8ljNj",
"device": "Desktop",
"system": "Windows 10",
"browser": "Chrome 154",
"selector": {
"path": "h1 > span:nth-child(2)",
"offset": {
"x": 46.484375,
"y": 60.416666666666664
},
"pathWithClass": ".block:nth-child(2)",
"scrollableSelector": null
},
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.0.0 Safari/537.36",
"screenWidth": 1920,
"screenHeight": 1032,
"viewportWidth": 1920,
"widgetVersion": "2.6.7",
"viewportHeight": 945,
"devDataOverview": {
"console": {
"log": 0,
"info": 0,
"warn": 0,
"error": 0
}
},
"devicePixelRatio": 2
},
"createdAt": "2026-10-02T15:59:01+02:00",
"resolvedAt": null
}
}
When a new comment is created on feedback
A piece of feedback can have lots of comments as a thread to communicate and collaborate. When a new comment is created on a piece of feedback in your project, the data will be sent to your endpoint as well. Here is an example of what this looks like:
{
"event": "comment.created",
"data": {
"id": 429,
"reporter": {
"type": "member",
"id": 105,
"name": "Elia Niccolini",
"email": "elia@feedbucket.app"
},
"body": "Test comment",
"attachments": [],
"membersOnly": false,
"feedback": {
"id": 975,
"project": {
"id": 98,
"key": "BGwnFKxEbvtHN5H4qaKd",
"name": "Feedbucket Staging",
"url": "https://myclientwebsite.com/demo/hG7LqNp43JlCLdS8ljNj",
"teamId": 100,
"createdAt": "2026-06-01T11:48:44+02:00"
},
"type": "screenshot",
"reporter": {
"type": "member",
"id": 105,
"name": "Elia Niccolini",
"email": "elia@feedbucket.app"
},
"resource": "https://d1amaofjw3j1p2.cloudfront.net/images/ebwmDYOFbMfxW58KnwsMqi6lYjDv4j43x6QrvrCi.jpeg",
"title": "Change this image",
"tags": null,
"attachments": [],
"integrations": [
{
"slug": "asana",
"integrationKey": "1219104956155553"
},
{
"slug": "clickup",
"integrationKey": "123m57f3pua"
}
],
"metaData": {},
"membersOnly": false,
"description": "Create a better image for this feedback",
"sessionDetails": {
"page": "https://myclientwebsite.com/demo/hG7LqNp43JlCLdS8ljNj",
"device": "Desktop",
"system": "Windows 10",
"browser": "Chrome 154",
"selector": {
"path": "h1 > span:nth-child(2)",
"offset": {
"x": 46.484375,
"y": 60.416666666666664
},
"pathWithClass": ".block:nth-child(2)",
"scrollableSelector": null
},
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.0.0 Safari/537.36",
"screenWidth": 1920,
"screenHeight": 1032,
"viewportWidth": 1920,
"widgetVersion": "2.6.7",
"viewportHeight": 945,
"devDataOverview": {
"console": {
"log": 0,
"info": 0,
"warn": 0,
"error": 0
}
},
"devicePixelRatio": 2
},
"createdAt": "2026-10-02T15:59:01+02:00",
"resolvedAt": null
},
"createdAt": "2026-10-02T16:01:27+02:00"
}
}
When the feedback is resolved (feedback updated event)
If the feedback is resolved from Feedbucket, the webhook sends data about this event as well to your endpoint. Here is an example:
{
"event": "feedback.updated",
"data": {
"id": 975,
"project": {
"id": 98,
"key": "BGwnFKxEbvtHN5H4qaKd",
"name": "Feedbucket Staging",
"url": "https://myclientwebsite.com/demo/hG7LqNp43JlCLdS8ljNj",
"teamId": 100,
"createdAt": "2026-06-01T11:48:44+02:00"
},
"type": "screenshot",
"reporter": {
"type": "member",
"id": 105,
"name": "Elia Niccolini",
"email": "elia@feedbucket.app"
},
"resource": "https://d1amaofjw3j1p2.cloudfront.net/images/ebwmDYOFbMfxW58KnwsMqi6lYjDv4j43x6QrvrCi.jpeg",
"title": "Change this image",
"tags": null,
"attachments": [],
"integrations": [
{
"slug": "asana",
"integrationKey": "1219104956155553"
},
{
"slug": "clickup",
"integrationKey": "123m57f3pua"
}
],
"metaData": {},
"membersOnly": false,
"description": "Create a better image for this feedback",
"sessionDetails": {
"page": "https://myclientwebsite.com/demo/hG7LqNp43JlCLdS8ljNj",
"device": "Desktop",
"system": "Windows 10",
"browser": "Chrome 154",
"selector": {
"path": "h1 > span:nth-child(2)",
"offset": {
"x": 46.484375,
"y": 60.416666666666664
},
"pathWithClass": ".block:nth-child(2)",
"scrollableSelector": null
},
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.0.0 Safari/537.36",
"screenWidth": 1920,
"screenHeight": 1032,
"viewportWidth": 1920,
"widgetVersion": "2.6.7",
"viewportHeight": 945,
"devDataOverview": {
"console": {
"log": 0,
"info": 0,
"warn": 0,
"error": 0
}
},
"devicePixelRatio": 2
},
"createdAt": "2026-10-02T15:59:01+02:00",
"resolvedAt": "2026-10-02T16:07:41+02:00",
"changes": {
"status": {
"from": "open",
"to": "resolved"
}
}
}
}
When the feedback gets re-opened (feedback updated event)
If the feedback is unresolved from Feedbucket, information about this event will be sent to your endpoint:
{
"event": "feedback.updated",
"data": {
"id": 975,
"project": {
"id": 98,
"key": "BGwnFKxEbvtHN5H4qaKd",
"name": "Feedbucket Staging",
"url": "https://myclientwebsite.com/demo/hG7LqNp43JlCLdS8ljNj",
"teamId": 100,
"createdAt": "2026-06-01T11:48:44+02:00"
},
"type": "screenshot",
"reporter": {
"type": "member",
"id": 105,
"name": "Elia Niccolini",
"email": "elia@feedbucket.app"
},
"resource": "https://d1amaofjw3j1p2.cloudfront.net/images/ebwmDYOFbMfxW58KnwsMqi6lYjDv4j43x6QrvrCi.jpeg",
"title": "Change this image",
"tags": null,
"attachments": [],
"integrations": [
{
"slug": "asana",
"integrationKey": "1219104956155553"
},
{
"slug": "clickup",
"integrationKey": "123m57f3pua"
}
],
"metaData": {},
"membersOnly": false,
"description": "Create a better image for this feedback",
"sessionDetails": {
"page": "https://myclientwebsite.com/demo/hG7LqNp43JlCLdS8ljNj",
"device": "Desktop",
"system": "Windows 10",
"browser": "Chrome 154",
"selector": {
"path": "h1 > span:nth-child(2)",
"offset": {
"x": 46.484375,
"y": 60.416666666666664
},
"pathWithClass": ".block:nth-child(2)",
"scrollableSelector": null
},
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.0.0 Safari/537.36",
"screenWidth": 1920,
"screenHeight": 1032,
"viewportWidth": 1920,
"widgetVersion": "2.6.7",
"viewportHeight": 945,
"devDataOverview": {
"console": {
"log": 0,
"info": 0,
"warn": 0,
"error": 0
}
},
"devicePixelRatio": 2
},
"createdAt": "2026-10-02T15:59:01+02:00",
"resolvedAt": null,
"changes": {
"status": {
"from": "resolved",
"to": "open"
}
}
}
}
When a comment is edited
If a comment on a piece of feedback is edited (only possible from Feedbucket Admin), information gets sent to your endpoint, like in this example below:
{
"event": "comment.updated",
"data": {
"id": 429,
"reporter": {
"type": "member",
"id": 105,
"name": "Elia Niccolini",
"email": "elia@feedbucket.app"
},
"body": "Create a nicer image for this feedback",
"attachments": [],
"membersOnly": false,
"feedback": {
"id": 975,
"project": {
"id": 98,
"key": "BGwnFKxEbvtHN5H4qaKd",
"name": "Feedbucket Staging",
"url": "https://myclientwebsite.com/demo/hG7LqNp43JlCLdS8ljNj",
"teamId": 100,
"createdAt": "2026-06-01T11:48:44+02:00"
},
"type": "screenshot",
"reporter": {
"type": "member",
"id": 105,
"name": "Elia Niccolini",
"email": "elia@feedbucket.app"
},
"resource": "https://d1amaofjw3j1p2.cloudfront.net/images/ebwmDYOFbMfxW58KnwsMqi6lYjDv4j43x6QrvrCi.jpeg",
"title": "Change this image",
"tags": null,
"attachments": [],
"integrations": [
{
"slug": "asana",
"integrationKey": "1219104956155553"
},
{
"slug": "clickup",
"integrationKey": "123m57f3pua"
}
],
"metaData": {},
"membersOnly": false,
"description": "Create a better image for this feedback",
"sessionDetails": {
"page": "https://myclientwebsite.com/demo/hG7LqNp43JlCLdS8ljNj",
"device": "Desktop",
"system": "Windows 10",
"browser": "Chrome 154",
"selector": {
"path": "h1 > span:nth-child(2)",
"offset": {
"x": 46.484375,
"y": 60.416666666666664
},
"pathWithClass": ".block:nth-child(2)",
"scrollableSelector": null
},
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.0.0 Safari/537.36",
"screenWidth": 1920,
"screenHeight": 1032,
"viewportWidth": 1920,
"widgetVersion": "2.6.7",
"viewportHeight": 945,
"devDataOverview": {
"console": {
"log": 0,
"info": 0,
"warn": 0,
"error": 0
}
},
"devicePixelRatio": 2
},
"createdAt": "2026-10-02T15:59:01+02:00",
"resolvedAt": null
},
"createdAt": "2026-10-02T16:01:27+02:00"
}
}
When feedback is deleted
The webhook will send a payload when a piece of feedback is deleted (this is only possible from Feedbucket Admin). Here is an example of how it will look:
{
"event": "feedback.deleted",
"data": {
"feedbackId": 975,
"project": {
"id": 98,
"name": "Feedbucket Staging"
}
}
}
Updated on: 05/11/2026
Thank you!
