What is Mailgun?#
Mailgun provides email sending infrastructure through API and SMTP, with tools for transactional and marketing email. Read more on the official website and in the official documentation.
Profile#
The Mailgun profile defaults to API delivery and supports API, HTTPS API, and SMTP transports.
- Transport scheme: mailgun+api (default), mailgun+https, or mailgun+smtp.
- API and HTTPS API: Mailgun API key and Mailgun domain are required.
- SMTP: Mailgun SMTP username and SMTP password are required.
- Optional region: Mailgun region can be set for any scheme and is passed to the transport when provided. Credential fields are marked secret where appropriate.
Create the connection#
Before you begin, create an account and prepare the credentials for the selected transport. Complete any sender or domain verification required by the provider.
- In WordPress admin, open Jooosi Mail → Connections and choose New connection.
- Enter a descriptive Connection name and select Mailgun in Profile.
- Choose the transport scheme and enter the matching required settings listed in the Profile section.
- Review the sender, routing, and advanced settings for this connection.
- Choose Create connection to save it.
For the shared connection workflow, see Provider profiles and transports.
Verify delivery#
Follow Send a test email and send it to a mailbox you can check. A test sends a real email. Check the mailbox and Jooosi Mail → Logs for the attempt status. See Email logs and resending for details.
Webhooks#
Mailgun webhooks are supported. Enable Webhooks under Advanced settings, add the Mailgun signing key as the shared Webhook secret, save the connection, then configure the displayed endpoint with Mailgun. The adapter requires the secret and verifies Mailgun’s timestamp/token signature. See the Provider webhooks guide for event setup.
Troubleshooting#
- For API delivery, check the Mailgun domain and region along with the API key; for SMTP, use the SMTP credentials.
- If webhook requests are rejected, confirm the shared Webhook secret matches the Mailgun signing key and that the signed request headers reach WordPress.