Managing SMTP Credentials in MailerLogic

If you connect multiple applications, clients, or environments to MailerLogic, using a separate SMTP credential for each one makes your setup easier to manage and more secure. This guide explains how to create, configure, rotate, disable, and manage SMTP credentials in MailerLogic.

If you're setting up SMTP for the first time, use the relevant SMTP setup guide first. This article focuses on managing multiple credentials.

Step 1: Open SMTP Credentials

Step 2: Understand the Default Credential

Every account includes a built-in SMTP credential. It may appear as 'Account (master)' or 'Default SMTP (account)'.

You can rotate its password, but you cannot rename, edit, disable, or delete it. For production applications, it is recommended to create a separate named credential instead of relying on the default credential.

Step 3: Create a New Credential

Now, click '+ Create credential'.

Step 4: Create SMTP Credential

Enter a descriptive 'Name' and configure a 'Sending domain', 'Daily limit', and 'Monthly limit'. Click 'Create' when you're finished.

Step 5: Save the Password

After creating the credential, MailerLogic displays the 'SMTP password'.

The password is shown only once. Save it immediately in a password manager or secure secrets manager before closing the dialog.

Step 6: Open Connection Details

Open the '⋯ menu' for a credential and select 'Connection details'.

Step 7: SMTP Connection Details

You'll find the information required to configure your application:

Setting	Details
SMTP server	Default MailerLogic server or your custom SMTP hostname
Port	`587` with STARTTLS is recommended
Alternate port	`2525` if port 587 is unavailable
Username	Your account email address or Customer ID
Password	The password generated for this credential

If the same email address is associated with multiple accounts, using your 'Customer ID' can help ensure the correct account is identified.

Step 8: Connect Your Application

Copy the connection details from MailerLogic into the SMTP settings of your application.

Use the credential's username and password rather than your MailerLogic account login password.

After configuring the application, send a test email to confirm that authentication and sending are working correctly.

Step 9: Manage an Existing Credential

Open the '⋯ menu' beside any credential to manage it. You can view its connection details, edit its settings, rotate its password, disable or enable it, or delete it.

Step 10: Rotate a Password

Use 'Rotate' when you need to replace an SMTP password.

Password rotation takes effect immediately, so the old password stops working as soon as the new one is generated. Before rotating, identify every application using the credential. After rotation, copy the new password and update each application.

Then send a test email to verify the new credentials. If you aren't sure whether a credential is still being used, consider disabling it first. If an application stops working, you can re-enable the credential without changing its password.

Step 11: Disable or Delete a Credential

Use 'Disable' when you want to temporarily stop an application from sending without permanently removing its credential.

Disabled credentials reject sending attempts until you enable them again.

Use 'Delete' when you're certain the credential is no longer required. Deleting a credential permanently removes it, but existing reports and sending history remain available.

Use a Custom SMTP Hostname

If your plan supports custom SMTP hostnames, you can configure a credential to use your branded SMTP hostname instead of the default MailerLogic server.

Open the credential's Edit settings and select the appropriate Custom SMTP hostname. Only hostnames with active SSL are available for selection.

See Custom SMTP Hostnames for information about setting up a branded SMTP hostname.

Follow SMTP Security Practices

For better security, create a separate credential for each application or environment instead of sharing one password across multiple systems.

Store SMTP passwords in environment variables or a secure secrets manager. Never commit them to source control or share them through email, chat, or support tickets.

For applications that only send from one domain, use a sending-domain restriction. Consider adding limits to staging, testing, or client-specific credentials.

Review your credentials regularly and disable or remove credentials that are no longer being used.

Troubleshooting

Authentication Failed

Your SMTP password is different from your MailerLogic login password. Confirm that the application is using the correct credential and that the credential is active.

If you recently rotated the password, update the application with the new password. You can also try using your Customer ID as the SMTP username.

Sending From the Wrong Domain Is Rejected

The credential may be restricted to a specific sending domain.

Check Edit on the credential and confirm that the application's From address matches the configured sending domain.

Sending Stops Earlier Than Expected

Check both the credential's daily or monthly limits and your account limits under Usage. The more restrictive applicable limit determines how much you can send.

SMTP Connection Times Out

If port 587 isn't working, try the alternate port 2525. Some networks or hosting providers restrict outbound SMTP connections.

I Lost My SMTP Password

SMTP passwords cannot be retrieved after the initial creation. Use Rotate to generate a new password and update the applications using that credential.

I Can't Create SMTP Credentials

SMTP credentials are available only on supported paid plans. If you're on a plan without SMTP access, the SMTP page displays an upgrade option.

Frequently Asked Questions

How many SMTP credentials can I create?

There is no fixed cap on named credentials. However, all sending through those credentials remains subject to your MailerLogic account and plan limits. Check Usage for your current limits.

Does each credential have its own sending reputation?

No. Sending reputation is associated with your account and sending domains, not individual SMTP credentials.

Can I see which credential sent an email?

Credentials have usage information and last-used details. For message-level information, use Reports.

Can team members manage SMTP credentials?

Credential management is available to the account owner and administrators. See Teams & User Invitations for more information.

Does deleting a credential delete its sending history?

No. Deleting a credential does not remove existing reports or analytics.

Was this article useful?

Dislike