. What You Need Before Connecting Mailgun
To connect Mailgun successfully, make sure you have:
Access to Settings → Customization and the Apps tab in Portal
A Mailgun account
Starter or Standard plan for custom domains
The free plan can only send to manually verified recipients
A verified Mailgun sending domain
SPF and DKIM are correctly set up
An authorized From address
Your:
Mailgun API Key
Webhook Signing Key
Account / Domain details
2. Enable Email Notifications in Portal
Before connecting Mailgun:
Go to Settings → Customization → Key Notifications
Ensure Email is enabled
If Email is disabled here, automatic emails will not be sent.
3. Open the Mailgun App
You can access Mailgun in two ways:
Go to Settings → Customization, click the info icon next to Email, then select Show Apps
Or go directly to the Apps tab and search for Mailgun
4. Configure Mailgun
In Apps → Mailgun, click View Integration
Enter:
Account / Domain information
API Key
Webhook Signing Key
Click Save to connect
Expected Result
If credentials are valid → integration saves successfully
If credentials are invalid → error message appears and integration is not saved
5. Email Templates in Portal
Portal supports two email templates:
Access is ready
Access is ready (Plain Email)
These templates are used when sending guest access emails.
6. Automatic Template Creation
When Mailgun is connected:
Portal checks if the required templates exist
If templates do not exist, Portal automatically creates default templates
Default templates are used immediately
Staff can edit templates later in Mailgun
No manual template creation is required to start sending emails.
7. Syncing Templates
Open the Templates tab in Portal
You will see:
Access is ready
Access is ready (Plain Email)
To sync successfully:
Template names must match exactly
Variable names must match exactly (case-sensitive)
No extra spaces or casing differences
When templates match:
Status shows Synced and Ready to Use
Click Check Templates any time you:
Change content
Update variables
Fix mismatches
8. Sending Emails via Mailgun
When Mailgun is connected and templates are synced:
Portal sends emails using your Mailgun domain
Branding and From address come from Mailgun
Emails are sent when:
A Key is created
Access is generated
Credentials are issued
Delivery Timing
Allow up to ~1 minute
Timestamps follow the Portal timezone
9. Fallback Email Behavior
If Mailgun is not connected:
Portal automatically uses its default mailing service
Emails are still sent
If a template is deleted in Mailgun:
Portal continues sending emails
System falls back to the default system template
Deleting a template in Mailgun does not break email delivery.
10. Customisation vs Manual Sharing (Important)
Email Disabled in Customisation
Automatic emails are not sent
Applies to:
Key creation
PMS-based flows
Automatic credential delivery
Manual Share Overrides Disable
When staff manually share credentials from Key Details:
Email is always sent
Even if Email is disabled in Customisation
Template used:
Property template (if exists)
Otherwise, default system template
11. Edge Cases & Errors
Invalid API or Webhook Key
Integration fails to save
Re-enter correct keys
Free Mailgun Plan
Can only send to manually verified recipients
Custom domain sending requires Starter or Standard
Template Mismatch
Sync fails
Variables render incorrectly
Fix names and variables exactly as shown in Portal
Rotated or Revoked Keys
Integration breaks
Update keys in Apps → Mailgun
12. Troubleshooting Checklist
Emails Not Arriving
Confirm Email is enabled in Customisation
Check Apps → Mailgun connection
Verify SPF/DKIM
Ensure templates show Synced and Ready to Use
Check spam folder
Review Mailgun logs
Allow ~1 minute
Templates Not Syncing
Names must match exactly
Variables must be case-sensitive
Click Sync Templates after changes
Need to Email Guests on Free Plan
Upgrade to Starter or Standard
Verify sending domain
13. Security Best Practices
Treat API & Webhook keys like passwords
Rotate keys regularly
Restrict access to Apps → Mailgun
Never share keys in chats or screenshots
FAQs
Q: Which templates are supported?
A: Access is ready, and Access is ready (Plain Email)
Q: Where do I find template variables?
A: In Portal’s Templates tab (case-sensitive)
Q: When are emails sent?
A: As soon as a Key is issued and access is generated
Q: What if Mailgun is not connected?
A: Portal uses its default mailing service
Q: Can I use different From addresses per property?
A: Yes, using separate verified Mailgun domains per property