Solomono Instructions E-mail services CONNECTING MAILGUN

CONNECTING MAILGUN

What You Will Configure

  • A Mailgun account.

  • A dedicated mail subdomain, such as mg.your-domain.com.

  • SPF, DKIM, two MX records, and a tracking CNAME.

  • A Domain Sending Key for Solomono Email Service.

  • Optional SMTP credentials for store system email.

  • A safe test to one recipient.

What You Need

  • A working email address for the Mailgun account.

  • Access to the domain DNS panel.

  • Administrator access to the Solomono store.

  • A test recipient address.

Warning. Treat a Domain Sending Key and SMTP password like passwords. Never include them in screenshots or documents.


 

1. Register a Mailgun Account

  1. Open https://signup.mailgun.com/.

  2. Enter your full name, company name, and work email.

  3. If you do not want to add a card, clear Add payment info now.

Figure 1. Mailgun signup without payment information

Warning. Accounts without a card have service limits. Pricing and limits can change; check the current signup page.

  1. Click Create Account.

  2. Confirm the email address or enter the verification code sent by Mailgun.

  3. Create a password and complete two-factor authentication if requested.

  4. After signing in, Mailgun opens the Dashboard.

Figure 2. Mailgun Dashboard

2. Add a Dedicated Subdomain

Use a separate subdomain such as mg.your-domain.com. This keeps Mailgun records separate from normal mail for addresses such as info@your-domain.com.

  1. Open Send → Sending → Domains.

  2. Click Add new domain.

  3. Enter a subdomain without https:// or www, for example mg.your-domain.com.

  4. Select the required region and create the domain.

Figure 3. Adding a custom Mailgun domain

3. Add and Verify DNS Records

  1. Open Domain settings → DNS Records in Mailgun.

  2. Open your DNS provider in another browser tab.

  3. Add the exact records shown in your Mailgun account.

Type and purpose

Example for mg.your-domain.com

TXT — Mailgun SPF

Host: mg; Value: v=spf1 include:mailgun.org ~all

TXT — DKIM signing

Host: selector._domainkey.mg; Value: long Mailgun key

MX — receiving

Host: mg; mxa.mailgun.org; Priority 10

MX — backup server

Host: mg; mxb.mailgun.org; Priority 10

CNAME — tracking

Host: email.mg; Value: mailgun.org


 

Result. The two MX records are not duplicates. Both mxa and mxb are required for redundancy.

Warning. Do not remove the root-domain MX record if it handles your normal mailbox. Mailgun records use host mg and do not replace the @ MX record.

Warning. Do not create a second _dmarc record when one already exists. The organizational-domain policy normally applies to subdomains.

  1. Save the records and return to Mailgun.

  2. Click Check status.

  3. SPF, MX, and CNAME should show Verified; DKIM should show Active.

Figure 4. Verified Mailgun DNS records

Important. DNS propagation can take from a few minutes up to 24–48 hours.


 

4. Create a Domain Sending Key

A Domain Sending Key can send only for one domain and is safer than a full account API key.

  1. Open Domain settings → Sending Keys.

  2. Click Add sending key.

  3. Enter a clear description, such as SoloMono production.

Figure 5. Creating a Domain Sending Key

  1. Click Create sending key.

  2. Copy the Sending API key immediately. Mailgun displays it only once.

Warning. Use this Domain Sending Key in the Solomono API KEY field. Do not use the account password or SMTP password.

5. Enable Email Service in Solomono

  1. Sign in to the store admin panel.

  2. Open Modules → SOLO modules.

  3. Find EMAIL_SERVICE_ENABLED and turn it on.

Figure 6. Solomono Email Service module

6. Connect Mailgun Through the API

  1. Open Settings → Integrations → Email Service.

  2. Click Change/Edit in the Email Service row.

  3. Select Mailgun.

  4. Paste the Domain Sending Key into API KEY.

  5. Enter the full subdomain in Domain, for example mg.your-domain.com.

  6. Click OK.

Figure 7. Mailgun API settings in Solomono

7. Test Delivery

  1. Open Send Email to Customers.

  2. Choose one customer, not all customers.

  3. Enter a test recipient, subject, and short message.

  4. Send the message and check Inbox and Spam.

  5. Open Mailgun Reporting/Logs and confirm Accepted or Delivered status.

Figure 8. Safe test form for one recipient


 

Optional: Store System Email Through SMTP

Configure SMTP when your Solomono setup sends automated store email separately from the Email Service API.

8. Create an SMTP User

  1. Open Domain settings → SMTP Credentials.

  2. Click Add new SMTP user.

  3. Enter a unique login, such as solomono-production.

  4. Keep Automatic password creation when available.

Figure 9. Creating a Mailgun SMTP user

  1. Click Create.

  2. Copy the full Login and Password immediately. The password is shown once.

Figure 10. Created SMTP user and Mailgun SMTP server settings

9. Enter SMTP Settings in Solomono

  1. Open Settings → Integrations → SMTP Settings.

Solomono field

Mailgun value

SMTP Port

587

SMTP Host

smtp.mailgun.org

SMTP Password

Password of the created SMTP user

SMTP Login

Full login, for example solomono-production@mg.your-domain.com

SMTP Security

tls

Certificate verification

Keep the current value unless support instructs otherwise


 

  1. Save each value.

Figure 11. Mailgun SMTP settings in Solomono

Warning. The SMTP password is not the Mailgun account password and not the Domain Sending Key.

Common Problems

Problem

What to check

DNS is not verified

The host does not contain the domain twice; values have no extra spaces; allow up to 48 hours.

DKIM is not Active

Copy the full selector and TXT key exactly as Mailgun shows them.

API authentication failed

Use an active Domain Sending Key and the exact Mailgun domain.

SMTP authentication failed

Use the full SMTP login and SMTP password, not the account password.

Unable to connect

Use smtp.mailgun.org, port 587, tls; confirm that hosting does not block outbound SMTP.

Rejected or not delivered

Check Mailgun Logs, From address, plan limits, and the suppression list.

Message goes to spam

SPF/DKIM are active, DMARC is not duplicated, and content is not spam-like.


 

Checklist

□ The Mailgun account is confirmed.

□ The sending subdomain is added.

□ SPF, MX, and CNAME show Verified; DKIM shows Active.

□ A Domain Sending Key is created and stored securely.

□ EMAIL_SERVICE_ENABLED is on.

□ Mailgun, API KEY, and Domain are saved in Solomono.

□ A test message to one recipient was delivered.

□ If required, SMTP is configured and tested.

Official Mailgun Documentation

Getting started: https://documentation.mailgun.com/docs/mailgun/get-started

Custom domains: https://documentation.mailgun.com/docs/mailgun/user-manual/domains/domains-custom

DNS verification: https://documentation.mailgun.com/docs/mailgun/user-manual/domains/domains-verify

API keys: https://documentation.mailgun.com/docs/mailgun/user-manual/api-key-mgmt/rbac-mgmt

SMTP: https://documentation.mailgun.com/docs/mailgun/user-manual/sending-messages/send-smtp

Last updated on: 24/06/2026
icon