Paste the URL 
Bring your own workflow
Send feedback to internal systems, automation scripts, data stores, or tools Ybug doesn’t integrate with directly.
Send feedback reports to your own endpoint
Need Ybug data in an internal tool, data warehouse, or workflow we don’t integrate with yet? Webhooks POST each new report as JSON, with screenshot URLs, metadata, custom fields, and attachments included.
Start free trialNo credit card required
Ybug widget
Feedback submitted
Webhook
POST sent · JSON delivered
Trusted by 1,000+ teams worldwide
How feedback gets into your webhook
Point-and-click capture
Users submit feedback — your endpoint gets the data
A user captures a screenshot, writes what happened, and submits the report. Ybug packages the report and sends it to your webhook URL as a JSON POST request.
- Works with reports from the widget and browser extension
- Screenshot URL, comment, reporter, and page context included
- Use it for internal tools, automations, dashboards, or custom queues
Structured payload
Get the raw report, not a flattened message
The payload includes report IDs, title, comment, reporter, URL, rating, NPS, priority, type, source type, timestamps, browser attributes, custom fields, attachment URLs, screenshot URL, video URL, and the Ybug report URL.
- JSON payload designed for machines, not copy-paste
- Custom fields and custom user data travel with the report
- Return an id or url when you want Ybug to store a back-reference
Routing & retries
Choose when reports leave Ybug
Send every report automatically, or keep auto-forwarding off and POST only the reports you approve. If delivery hits a temporary failure, Ybug retries with exponential backoff.
- One project-level webhook URL per Ybug project
- Automatic delivery or manual forwarding after triage
- Temporary failures retry up to 5 times
Secure delivery
Trust the reports your endpoint receives
Add a signing secret and your app can verify each request came from Ybug before acting on it. Reject anything that doesn’t match.
- Accept feedback with more confidence
- Ignore requests that don’t match your project secret
Set it up in under 5 minutes
Bring your endpoint, paste the URL into Ybug, and decide whether reports should be sent automatically or after review.
1.
Create your endpoint
Prepare a public URL that accepts JSON POST requests from Ybug.
2.
Paste the URL
Open your Ybug project integrations and add your webhook endpoint URL.
3.
Add a secret
Optionally add a signing secret so your app can verify each request.
4.
Start receiving
Send a test request, then let new feedback flow into your own system.
“I run a software development agency and I've tried every other feedback tool out there - Ybug is the clear winner. It will offer all the critical features that you need. Ybug offers more thorough integrations (via Zapier, API, webhooks, etc.) while its feedback widget is superior to them. Also, price-wise it absolutely beats other tools.”
Rodrig N.
Managing Partner
Why teams use
Ybug Webhooks
Webhooks are for the workflows only your team has. Ybug collects the report; your endpoint decides what happens next.
Full report context
Receive screenshot URLs, metadata, custom fields, reporter details, attachments, and the full Ybug report link.
Developer-friendly payload
Use predictable JSON instead of scraping email notifications or rebuilding context from chat messages.
Security basics included
Optional HMAC signing, plus standard HTTP status codes — 2xx to acknowledge, 5xx to retry, 410 to unsubscribe.
Want less custom code?
Same report, more ready-made destinations
Frequently asked questions
What does the Webhook integration send?
Ybug sends full report context as JSON, including the feedback text, screenshot and video links, page URL, reporter details, browser context, custom fields, attachments, and the Ybug report link.
How secure is the Webhook integration?
Ybug can sign webhook requests with a project secret, so your endpoint can verify that incoming requests came from Ybug before processing them. You control the destination URL and can rotate the secret in the integration settings.
What should my endpoint return?
Return any 2xx HTTP status code to acknowledge delivery. Other responses are treated as failed delivery, and temporary failures are retried up to 5 times.
Can I review reports before sending them to my webhook?
Yes. You can POST every report automatically, or keep auto-forwarding off and send selected reports from Ybug manually.
Can our users submit feedback without logging in?
Yes. Users can submit visual feedback and bug reports directly from your app in a few clicks – no signup or login required. Less friction means more useful feedback.
Connect Ybug to your own tools
POST visual feedback reports as structured JSON to your own endpoint.
Start free trialNo credit card required