Webhooks let you receive real-time notifications when events happen in Revuloop, such as new survey responses or survey status changes.
Setting Up Webhooks
Creating a Webhook
- Go to Organization Settings → Webhooks
- Click Create Webhook
- Enter your endpoint URL (must be HTTPS)
- Select which events to subscribe to
- Save and test
Via API
POST /api/v1/webhooks
{
"url": "https://your-server.com/webhook",
"events": ["RESPONSE_SUBMITTED", "SURVEY_LAUNCHED"]
}Available Events
Response Events
- RESPONSE_SUBMITTED: New survey response received
- RESPONSE_FILTERED: Response filtered by rules
- RESPONSE_STARTED: Respondent started a survey
- RESPONSE_PARTIAL: Partial response saved
Survey Lifecycle Events
- SURVEY_CREATED: New survey created
- SURVEY_UPDATED: Survey modified
- SURVEY_LAUNCHED: Survey went live
- SURVEY_PAUSED: Survey paused
- SURVEY_CLOSED: Survey closed
- SURVEY_DELETED: Survey deleted
Analytics Events
- SMART_ANALYTICS_GENERATED: Smart survey analytics refreshed
Security
HMAC Signature Verification
Every webhook delivery includes an HMAC signature in the headers. Verify this signature to ensure the payload is authentic and hasn't been tampered with.
Delivery Retries
Failed deliveries are retried with exponential backoff. You can view delivery history and manually retry from the dashboard.
Managing Webhooks
Delivery History
View the status of each webhook delivery:
- Success/failure status
- Response code from your server
- Payload that was sent
- Retry attempts
Testing
Use the Test button to send a sample payload to your endpoint without waiting for a real event.