SMTP Credentials

SMTP credentials are username/password pairs used to authenticate SMTP connections. They’re separate from API keys — use SMTP credentials when your application sends email via SMTP, and use API keys when using the REST API.

Managing SMTP credentials

SMTP credentials are managed through the RelayPost dashboard. Go to Settings → SMTP Credentials to create, view, and manage your credentials.

Create credentials

1. Go to Settings → SMTP Credentials in the dashboard
2. Click Create Credential
3. Enter a username (or leave blank to auto-generate one, e.g. smtp_a1b2c3d4)
4. Add an optional description (e.g. “Production Rails app”)
5. Click Create

Caution

The password is only shown once at creation time. Copy and store it securely — it cannot be retrieved later.

Username rules

• 4-50 characters
• Letters, numbers, and underscores only
• Must be unique within your organization

View credentials

The Settings → SMTP Credentials page lists all credentials for your organization, showing:

• Username
• Description
• Active/inactive status
• Last used date
• Creation date

The password hash is never exposed after creation.

Regenerate password

If a password is compromised:

1. Go to Settings → SMTP Credentials
2. Find the credential and click Regenerate Password
3. Copy the new password — the old one stops working immediately

Deactivate / activate

Temporarily disable a credential without deleting it:

1. Go to Settings → SMTP Credentials
2. Toggle the credential’s active status

Deactivated credentials reject all SMTP connections. Re-enable anytime.

Delete a credential

To permanently remove a credential:

1. Go to Settings → SMTP Credentials
2. Click Delete on the credential

Caution

Deletion cannot be undone. Any application using this credential will immediately lose SMTP access.

Security notes

• Rotate passwords regularly
• Use separate credentials per application or environment
• Deactivate credentials you’re not actively using
• Never commit SMTP passwords to version control