Skip to main content
By default, Mailgun API keys have the required permissions for Novu to auto-configure webhooks when email activity tracking is enabled in the Novu dashboard. In most cases, you won’t need to do any manual setup. However, you might want to track specific Mailgun events the Novu supports.
Email Activity Tracking is available on Novu Cloud and Enterprise self-hosted only. It is not included in the Community self-hosted edition. Contact us at sales@novu.co to learn more about Enterprise self-hosted licensing.
This guide explains how to manually add new webhooks for specific events directly from your Mailgun dashboard.

​
Step 1: Get your webhook URL from Novu

First, you need the unique webhook URL from your Novu dashboard that will receive events from Mailgun.
  1. Log in to the Novu dashboard.
  2. Navigate to the Integration Store page in Novu and then select your Mailgun integration.
  3. Enable the Email Activity Tracking toggle. This generates an Inbound Webhook URL unique to your integration.
  4. Copy the URL, you’ll use it in the Mailgun dashboard if you want to add specific events manually. Mailgun Inbound Webhook URL

​
Step 2: Add an event webhook in Mailgun

Next, log in to your Mailgun account to create a new webhook for the specific event you want to track.
  1. Log in to your Mailgun account.
  2. Navigate to Send section in the left sidebar, and then select Webhooks.
  3. Click Add webhook. Add Mailgun webhook
  4. A menu will appear. Configure the webhook with the following settings:
    • Event type: Select the event you want to track from the dropdown menu.
    • URL: Paste the Inbound Webhook URL you copied from Novu.
  5. Click Create Webhook. Create Mailgun Webhook

​
Step 3: Add additional events (Optional)

Your new webhook for the selected event is now active. To track other events, you must repeat the process in Step 2 for each one. We recommend adding webhooks for all events that Novu supports:
  • Delivered messages
  • Opens
  • Clicks
  • Unsubscribes
  • Spam complaints
  • Permanent failures
Once configured, Mailgun will begin sending real-time data for these events to Novu, which you can monitor in your Activity Feed.