Secure Webhooks for
custom backends
Connect ProofBeer testimonial forms directly to your servers. Receive detailed HTTP POST JSON payloads detailing reviews, customer information, ratings, and submission timestamps.
Form submit trigger dispatches JSON POST request instantly.
{
"event": "form.submitted",
"rating": 5,
"name": "Sarah Jenkins"
}
How This Helps Your Business
Unlock infinite product integration possibilities. Custom Webhooks empower your engineers to connect review feedback to custom apps, proprietary databases, and internal APIs without middle-man subscriptions.
Zero Middle-man Fees
Avoid expensive third-party automation tool rates. Send data directly to your own server endpoints for free at any volume.
Real-time Event Synchronization
Fires the exact millisecond a customer clicks submit. Ideal for microservices, live databases, and synchronous server workflows.
Complete Data Sovereignty
Route sensitive customer contact data and reviews directly into your private, secure cloud databases without routing through middleman APIs.
Configure Webhooks in Form Editor
Open Form Configure Settings
Navigate to the form you want to connect in the ProofBeer dashboard, click the "Configure" tab, and open the "Integrations" section.
Enter Endpoint URL and Label
Click "Add Webhook" in the Custom Webhook panel. Paste your destination HTTPS URL target and enter an optional reference label (e.g., "Production API").
Save the Connection
Click "Connect" to store the webhook config. Multiple custom webhooks can be connected to route submissions to multiple servers.
Test Webhook & Verify Payload
Click "Test" on the integration row to dispatch a live mock JSON POST payload. Verify your server parses the structure correctly and returns a "200 OK" response.
{
"event": "form.submitted",
"submitted_at": "2026-03-01T10:30:00.000Z",
"workspace_id": "your-workspace-id",
"form_id": "form-xxxx",
"submission_id": "sub-xxxx",
"answers": [
{
"question": "How satisfied are you?",
"answer": "5 - Very Satisfied",
"field_type": "rating"
}
]
}Secure HTTPS: Connect with peace of mind. Webhooks run on secure endpoints. Includes validation testing with live sample JSON outputs.
5 High-Impact Business Use Cases
See how developer and product operations teams implement custom webhooks to scale and automate user databases.
Sync with Proprietary User Databases
Route form submission structures straight to your internal SQL or NoSQL production databases. Keep customer records completely synced and accurate in real-time.
Automated In-App User Rewards
Trigger immediate loyalty points, account credits, or feature access tokens for users who complete customer surveys, increasing survey completion rates.
Internal Audit & Secure Encryption
Perform server-side security checks on incoming reviews, anonymize sensitive customer names, and encrypt emails before loading them into support channels.
Automated Account & Trial Provisioning
Instantly spin up demo accounts, provision client sandboxes, or email customized welcome PDFs to prospects who complete onboarding forms.
Automated Spam & Abuse Auditing
Pass the webhook JSON payload through custom server-side NLP models or spam detection libraries to automatically screen out reviews containing abuse or profanity.
Build a reliable webhook receiver
A webhook is an HTTP POST that ProofBeer sends to your server when something happens, such as form.submitted. Your endpoint should use HTTPS, accept JSON, verify the signature, store the data and respond with a 2xx status quickly. Do heavy work, such as sending emails or calling other APIs, after you have acknowledged the request, so slow processing does not cause timeouts. The payload includes event, rating, name, submitted_at, workspace_id, form_id, submission_id and an answers array.
Receiver checklist
- Verify the signature using the signing secret sent in the request headers before trusting the body.
- Use submission_id as an idempotency key so repeated deliveries do not create duplicate records.
- Return 200 quickly; queue background work.
- Log raw payloads for a few days while testing, then remove personal data you do not need.
- Version your handler so new fields in the payload do not break parsing.
Troubleshooting Webhooks setup
My endpoint receives nothing
Check the URL is public, uses HTTPS and is not blocked by a firewall. Test with a tool such as a request inspector.
Signature verification fails
Use the raw request body, not a parsed and re-serialised one, and the exact secret from ProofBeer.
I receive duplicates
Deliveries can repeat after timeouts. Deduplicate on submission_id.
My server times out
Acknowledge immediately and process in the background.
Payload fields differ between forms
The answers array depends on each form's questions. Parse by field type and question ID.
Detailed Webhooks setup, step by step
- Create an HTTPS endpoint on your server.
- In ProofBeer form settings open webhooks and paste the endpoint URL.
- Copy the signing secret and store it securely.
- Send a test event.
- Verify the signature using the raw body.
- Respond with a 2xx status.
- Store the payload and use submission_id for deduplication.
- Monitor failures and rotate the secret if needed.
Common mistakes to avoid
- Parsing the body before verifying the signature.
- Logging secrets.
- Doing slow work before replying.
- Not handling duplicate deliveries.
- Using HTTP instead of HTTPS.
How the Webhooks integration works
When an event occurs, ProofBeer sends an HTTPS POST with JSON to your endpoint and includes a signature header created with your signing secret. Your server verifies it, stores the data and returns a 2xx status.
Real-world ways to use it
Database sync
Store each submission in your own database.
Rewards
Trigger a coupon when a customer submits a review.
Audit trail
Log every submission for compliance.
Launch checklist
- Build an HTTPS endpoint.
- Store the signing secret securely.
- Verify signatures.
- Deduplicate on submission_id.
- Return 2xx quickly.
- Log failures.
- Test with a sample payload.
How this compares with the alternatives
Webhooks give you direct control and low latency. Zapier is easier to set up but costs tasks. Use webhooks if you already have a backend.
Security and compliance
Treat webhook data as personal data. Use HTTPS only, restrict who can read logs, rotate the signing secret if it leaks, and delete data on request. Check which plans include webhooks: ProofBeer's pricing page lists custom webhooks on Pro and full API and webhook access on Advanced.
More questions
What does a ProofBeer webhook payload contain?
An event name, rating, name, timestamp, workspace, form and submission IDs, and an array of answers with question text and field types.
Frequently Asked Questions
How do I set up webhooks in ProofBeer?
Under your Form Settings, click on the Integrations tab, enter your target server URL, select webhook event triggers, and save to receive instant JSON payloads.
What payload data does ProofBeer send in webhooks?
Webhook payloads contain detailed submission metadata, including customer name, email, rating, text feedback, custom questions, and video URL links.
Can I secure my webhooks using signature verification?
Yes. ProofBeer sends a unique webhook signing secret in the request headers, allowing your server to verify that the payload originated securely from us.
ProofBeer is an all-in-one social proof platform for websites. It combines AI-assisted feedback forms, automatic Google, Facebook and Instagram review sync, and embeddable testimonial widgets in one dashboard. ProofBeer is software and is not related to beer or alcohol.
What you can do with it
Push responses into a data warehouse. Create tickets in a custom support tool. Trigger internal alerts. Sync testimonials to a CMS. Feed an NPS dashboard.
How to set it up
- Create an HTTPS endpoint that accepts POST requests and returns a 2xx status quickly.
- In ProofBeer, open the form editor, then Integrations, then Webhooks, and add the endpoint URL.
- Copy the signing secret and store it securely.
- Send a test event and check your logs.
Frequently asked questions
What are ProofBeer webhooks?
ProofBeer webhooks send form submissions as JSON over HTTPS to an endpoint you control, with signature verification and retries. They let developers push feedback and testimonials into their own databases, ticket tools or dashboards without using a third-party automation service.
Can I test webhooks before going live?
Yes. Send a test response from your form and inspect the request in your logs, or use a request-inspection service while developing. Check the signature, the response code and how your system handles a duplicate event before pointing the webhook at production.
Link your backend servers today
Activate real-time webhook endpoints inside the Form builder settings. Setup is free and takes less than a minute.