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:

  1. Get the raw webhook body
  2. Get the timestamp from the request header
  3. Compute HMAC-SHA256 of the body using your webhook secret
  4. Compare the computed signature with the one in the header

Setting Up Webhooks

  1. Go to Organization Settings → Webhooks
  2. Click "Add Webhook"
  3. Enter your webhook URL (must be HTTPS)
  4. Select which events to subscribe to
  5. Copy your webhook secret and store it safely
  6. Click "Create"

⚠️ Security Alert

Never expose your webhook secret in client-side code. Store it securely on your server-side environment variables.