How do I configure webhooks?

Updated Nov 2, 2026

Webhooks send event notifications to your endpoint with HTTP POST.

Steps

  1. Go to Settings, tab Integrations, and find Webhooks.
  2. Enter the Webhook URL. Use Add webhook for another destination and Switch webhook to edit an existing one.
  3. Turn on Activate. Only active subscriptions receive events.
  4. Choose the events: Opens, Clicks, Replies, Bounces, Unsubscribes, Complaints and Test events.
  5. Optionally turn on Require HMAC-SHA256 signing (recommended).
  6. Click Save webhook.

Delivery

  • Return a 2xx status once you have stored the event. Network errors and 5xx responses are retried for 24 hours; other statuses are not retried.
  • The same event can arrive more than once; deduplicate on organization_id, event_type and event_id.
  • Bounces are reported only when the bounce report reaches MailRush and can be matched to a sent email.

More details in the FAQ

The FAQ is in the MailRush.io app under Support (sign-in required).

Related articles

Didn't find what you need?

Sign in to MailRush.io and open a support ticket, and our support team will get back to you.

Contact support