Help Center/Admin Operations/How to rotate or switch the credentials of an email provider
Admin Operations•Last updated: 2026-10-20•3 min read

How to rotate or switch the credentials of an email provider

The "Rotate credentials (Super Admin)" button on a provider card replaces the stored SMTP username and password, or switches the provider back to the deployment environment variables.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Find the card

On /admin/communications/email-engine/providers locate the provider under "Configured providers" and click "Rotate credentials (Super Admin)".

2

Choose the source

Pick "Store new credentials encrypted" (type the new "New username" and "New password") or "Use deployment environment variables" (no secret is typed; any stored ciphertext is cleared).

3

Save

Click "Save credentials". The password is sent once, cleared from the form at once and never displayed. A green banner confirms and the card text updates.

4

Verify

Click "Health check" on the card to confirm the new credentials work.

Expected Operational Outcome

The provider uses the new credentials and the card shows the new credential source.

Troubleshooting & Failure Modes

Symptom: A red banner reads "Requires Super Administrator."
Likely Cause: The rotate route is limited to Level 5 accounts.
Resolution: Use a Super Administrator account.

Was this guide helpful?

Help us refine our platform documentation