Back to Help Center
Webhook Security
5 min read
What are Webhooks?
Webhooks are HTTP callbacks that allow Reminder Flow to send real-time data to your application when events occur (like emails being sent or opened).
Webhook Security Best Practices
- Verify signatures: Always validate webhook signatures to ensure requests come from Reminder Flow
- Use HTTPS: Webhook URLs must use HTTPS for encryption in transit
- Validate payloads: Check that required fields exist before processing
- Implement retries: Handle failed webhook deliveries gracefully
- Rate limiting: Implement request rate limiting on your endpoint
Verifying Webhook Signatures
Every webhook request includes an X-Reminder Flow-Signature header. Verify this signature by:
- Get the raw webhook body
- Get the timestamp from the request header
- Compute HMAC-SHA256 of the body using your webhook secret
- Compare the computed signature with the one in the header
Setting Up Webhooks
- Go to Organization Settings → Webhooks
- Click "Add Webhook"
- Enter your webhook URL (must be HTTPS)
- Select which events to subscribe to
- Copy your webhook secret and store it safely
- Click "Create"
⚠️ Security Alert
Never expose your webhook secret in client-side code. Store it securely on your server-side environment variables.
