For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

Mailgun

Connect Mailgun to Email, and its webhook for bounces, complaints, opens and clicks.

Mailgun sends through your own verified domain and, with its webhook, reports bounces, spam complaints, opens and clicks back into Norbix.

Get your credentials

  1. Open the Mailgun console and sign in.

  2. Sending → Domains → Add new domain: add mg.acme.com, create the DNS records Mailgun shows, and wait until the domain is verified. Note its region: US or EU.

  3. API Security: copy the Private API key.

  4. Sending → Webhooks: copy the HTTP webhook signing key.

  5. For opens and clicks, turn on open and click tracking in the domain settings.

Connect it in Cloud

Where: Email → Integrations → Add New Integration → Mailgun → Connect · /projects/<project>/emails/integrations/new/mailgun

Field
Required
What it does
Example

Sender Email Address

yes

An address on the verified domain.

hello@mg.example.com

Sender Display Name

no

The "from" name.

Acme

Sender Domain

yes

The verified Mailgun domain.

mg.example.com

Mailgun Region

yes

US (default) or EU — where the domain lives.

EU

Mailgun Private API Key

yes

The private key. Stored encrypted, never shown again.

—

Webhook Signing Key

yes

Checks that webhook calls really come from Mailgun.

—

Integration Name

yes

The name in Norbix.

Mailgun (example)

New Mailgun Integration form filled with made-up values: Sender Email Address, Sender Display Name, Sender Domain mg.acme.example, Mailgun Region US, keys
The filled form (made-up values).

Press Save. The integration opens with its id (int_EHCfsQqCmMCrhLzxdrX3u) and badges.

Editing Mailgun integration: badges DISABLED, NOT TESTED, NOT CONFIRMED; Sender Email Address hello@mg.example.com; Sender Domain mg.example.com
After save (this one was just disabled for the Disable page).

Connect the webhook (bounces, complaints, opens, clicks)

Norbix does not register the webhook for you — paste its URL into Mailgun. The URL is built from your Hub address, your project id and the integration id:

For an integration saved in another environment than PROD, add the environment: …/<integrationId>?env=TEST.

In Mailgun, Sending → Webhooks → Add webhook: add this URL for Permanent failure, Spam complaints, Opens and Clicks. Do not add Delivered, Unsubscribes or Temporary failure: Norbix accepts them with 200 and changes nothing.

What each event does: a permanent failure or spam complaint blocks marketing to that address; an open sets the message to Viewed; a click to Clicked (see the message log). The webhook only accepts calls signed with this integration's signing key for this exact project and integration.

Test and set as default

On the saved integration: Test Email Recipient → Test integration → I received it (Test an integration), then Actions → Set as default (Set as default).

Common errors

Message
Cause
Fix

Property Domain creation failed (CM-ERRORS-PROPERTY-002) on save

Sender Domain is not a valid public domain name (a reserved name such as mg.acme.example is refused).

Use the domain exactly as Mailgun shows it.

Test failed, unauthorized

Wrong private key, or the wrong Mailgun Region.

Check the key and pick the region of the domain.

Webhook events refused (Mailgun log shows 400)

Wrong signing key, or a TEST integration's URL without ?env=TEST.

Fix the key or the URL; Mailgun retries for about 8 hours.

Webhook events refused (406)

A wrong id in the URL, a misspelled environment, or the integration is not Mailgun.

Fix the URL; Mailgun stops at once.

Do it from code

API: Save Email Integration

Last updated