Webhooks

Receive real-time HTTP notifications when important events occur in your StweetHQ workspace, such as new testimonials or status changes.

Overview

Webhooks let you subscribe to events in StweetHQ and receive POST requests to your server whenever those events fire. This enables real-time integrations without polling the API, such as sending a Slack notification when a new testimonial is submitted or syncing data to your CRM.

Supported Events

StweetHQ supports webhook events for testimonial.created, testimonial.approved, testimonial.rejected, collection.updated, and widget.viewed. Each event payload includes the full resource object along with metadata like the event type, timestamp, and workspace ID.

Configuration

Add webhook endpoints from the Settings page in your dashboard. Specify the URL, select which events to subscribe to, and optionally add a secret for signature verification. StweetHQ signs every webhook payload with HMAC-SHA256 so you can verify authenticity on your server.

Retry Policy

If your endpoint returns a non-2xx status code, StweetHQ will retry the delivery up to five times with exponential backoff. Failed deliveries are logged in the dashboard where you can inspect the payload and manually re-trigger them for debugging.

Next Steps

Pair webhooks with the embedding guide to build dynamic, real-time testimonial experiences, or review the code examples for webhook handler implementations in popular frameworks.