Authentication is required any time you wish to relay messages through our platform. When using our API, you need to use one of your account's API keys (either the Private API Key or the Public Validation Key).
For our SMTP server, you need to use your domain's SMTP credentials.
Note: If the API keys are not visible within your Control Panel, verify your permissions with your account's Admin user.
Inside the Mailgun Control Panel (options displayed down the left-hand side on a dark column), the API keys appear on only one page. To view the API keys, use the following instructions:
- Click on Settings on the left-hand side of your the Mailgun dashboard.
- Select Security & Users from the menu below on the left-hand side.
- Click on the API security tab.
- On the following page, under the API Keys section, you'll see both your Private and Public API keys.
- Click on the eye icon to make the full API key visible.
Your SMTP credentials are different for each domain you add. You can find your default credentials, and add more, by clicking through to your domain settings.
Inside the Mailgun Control Panel (options displayed down the left-hand side on a dark column), the SMTP Credentials are not visible and can only be reset. To update your SMTP credentials, use the following instructions:
- Click on Sending on the left-hand side of your the Mailgun dashboard.
- Select the specific domain.
- On the following page click on Domain Settings, then click SMTP credentials.
- To update the password click Reset Password.
- Confirm your password reset by clicking Reset Password in the pop-up.
- Your SMTP credential's new password will be displayed on the top-right corner within a green pop-up. Save this password by double-clicking on the string and copy+pasting into a safe location, as it will not be revealed again.
What Ports Does Mailgun Support?
Our servers listen on ports 25, 465 (SSL/TLS), 587 (STARTTLS), and 2525.
A few things to note when selecting a port:
- Some ISPs block or throttle SMTP port 25. We recommend using port 587 instead.
- Google Compute Engine allows port 2525 for SMTP submission.
- Mailgun IPs change frequently, we do not recommend setting up firewall restrictions against our IP addresses.
- See our SMTP documentation in the users manual to learn how to configure the most popular SMTP software and email clients to work with Mailgun.
For a more detailed explanation on ports check out our blog post.
If any questions arise, just reach out to our Support team via the Support tab in your Mailgun control panel!