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
Open the Mailgun console and sign in.
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.API Security: copy the Private API key.
Sending → Webhooks: copy the HTTP webhook signing key.
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
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)

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

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
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
Last updated