Chapter: Connect Mailgun

Integrations

Connect Mailgun

This workspace’s emails go out via your Mailgun domain and your sender address.

Where to connect

In VentionDesk under Workspace › Sources › “Add source”, category Mail, then Mailgun. Only the owner may connect, edit and remove.

Step by step

  1. Open app.mailgun.com › Send › Sending › Domains › “Add new domain”. Mailgun recommends a subdomain such as mg.your-domain.com. Choose the region here: EU stores data in the EU — it cannot be changed later.
  2. Set the DNS records shown: SPF (TXT with include:mailgun.org) and DKIM (TXT); the CNAME for tracking is optional. After “Verify DNS settings”, the domain must show as “Active” — otherwise VentionDesk rejects it when saving.
  3. Under Account › API Security, create an API key with the weakest role that may send and read domains (at Mailgun, “Developer”). The key is only shown once.
  4. Enter the key, domain, region and sender address. The sender address should be on the sending domain or its parent domain, otherwise the recipient’s DMARC check fails. To check, VentionDesk reads the domain once (GET /v3/domains/…).
  5. Your customers’ replies still go to your VentionDesk mailbox (Reply-To) and land in the ticket. Bounces and complaints are only visible in your account with the provider — VentionDesk learns nothing about them. If sending fails, the reason is shown on this connection and the email counts as not sent; VentionDesk never silently falls back to another sender.
Guide at the provider(opens in a new tab)

What the dialog asks for

FieldEntryWhere from
API keyRequired | secretMailgun › Account › API Security › “Add new key”. A pure “Domain Sending Key” is not enough: it may not read the domain, and that is exactly what VentionDesk checks when saving.
Sending domainRequiredThe domain verified under Send › Sending › Domains, e.g. mg.your-domain.com.
RegionRequiredeu for accounts in the EU region (api.eu.mailgun.net), us for the US region (api.mailgun.net) — the one in which the domain was created.
Sender addressRequiredThe address your emails come from, e.g. invoice@your-domain.com — on the domain you verified with the provider. VentionDesk takes the name in front of it from “Settings › Email sender”.

VentionDesk stores secret entries encrypted and never shows them again. They are only saved once the provider confirms the access; if you edit a connection and leave a secret field empty, the previous value is kept.

All providers at a glance: IntegrationsWebhook URLs: Webhooks

Connect Mailgun | VentionDesk Docs