Webhooks

Webhooks enable your application to receive real-time HTTP notifications whenever feedback or comments are created or updated in Userback — useful for automating workflows, syncing with project management tools, and triggering custom integrations.

📘
Before you start

Set up a server endpoint to handle incoming webhook requests.

Webhooks require the Business Plus plan or higher.

How to set up webhooks

Go to the Connect page in your project.
Select "Connect" under Webhooks and add your webhook URL.
Use the built-in "Test" feature to validate the webhook setup.

Webhook events

Webhooks can notify you of the following events:

Feedback events

Event	Description
New Feedback	Triggered when new feedback is added.
Feedback Assigned	Triggered when feedback is assigned to a user.
Status Changed	Triggered when feedback status is updated (e.g., Open → Resolved).
Priority Changed	Triggered when feedback priority changes.
Feedback Voted	Triggered when feedback votes are modified.
Feedback Deleted	Triggered when feedback is removed.

Comment events

Event	Description
New Comment	Triggered when a new comment is added to feedback.
Comment Updated	Triggered when an existing comment is edited.
Status Changed	Triggered when a comment status changes (e.g., Public → Private).
Comment Deleted	Triggered when a comment is removed.

Webhook payload structure

Each webhook sends data via HTTP headers and a JSON payload.

Headers

Content-Type: application/json; charset=utf-8  
User-Agent: Userback-Webhook

Payload example

{
  "action": "create",
  "type": "feedback",
  "data": {
    "id"                : 2007850,
    "feedback_type"     : "bug",
    "project"           : "Pied Piper",
    "email"             : "[email protected]",
    "name"              : "John Doe",
    "priority"          : "Urgent",
    "category"          : "UI,Frontend",
    "assignee"          : "John Doe",
    "rating"            : 5,
    "vote"              : 0,
    "dpi"               : "2.0",
    "colour_depth"      : "24-bit",
    "title"             : "Feedback Title",
    "description"       : "...",
    "browser"           : "Chrome 138.0.7204",
    "window_size"       : "1920 x 1080",
    "screen_resolution" : "1920 x 1080",
    "video"             : "https://example.com/video.mp4",
    "screenshot"        : "https://example.com/screenshot.png",
    "attachment"        : "https://example.com/attachment.zip",
    "comments"          : {...}, // screenshot pin comments
    "custom_data"       : {...},
    "user_data"         : {...},
    "console_logs"      : {...},
    "html_content"      : "...",
    "share_url"         : "https://app.userback.io/viewer/123456/98765/2007850MSNv8n6f/"
  },
  "timestamp": 1667263011,
  "url": "https://app.userback.io/viewer/123456/98765/2007850MSNv8n6f/"
}

Payload fields

Key	Description
`action`	The type of event (`create`, `update`, `remove`).
`type`	The entity targeted (`feedback`, `comment`, etc.).
`data`	The event-specific details.
`timestamp`	The time of the event in Unix format.
`url`	Link to the affected entity in Userback.

Need help? Visit the Help Center or use the chat bubble on this page to contact our support team.