Integrations
Configuring custom webhooks
Send RedProwler events to your own endpoints with signed webhooks.
Requirements
Custom webhooks require a Pro or Team plan.
Adding a webhook
Go to Settings → Integrations and find the Webhooks section. Enter your endpoint URL and select which events you want to receive. RedProwler will automatically generate an HMAC-SHA256 signing secret for verifying payloads.
Verifying webhook signatures
Every webhook request includes two headers for verification:
- X-Webhook-Signature — HMAC-SHA256 hash of the request body, signed with your webhook's secret
- X-Webhook-Event — the event type (e.g., "lead.high_relevance")
Payload format
Each webhook sends a JSON payload with three fields:
- event — the event type string
- timestamp — ISO 8601 timestamp of when the event occurred
- data — event-specific data (lead details, competitor mention details, etc.)
Note: Webhooks have a 10-second timeout. If your endpoint doesn't respond within 10 seconds, the delivery is considered failed. Use asynchronous processing for heavy workloads.