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?
Step-by-Step Procedure
Find the card
On /admin/communications/email-engine/providers locate the provider under "Configured providers" and click "Rotate credentials (Super Admin)".
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).
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.
Verify
Click "Health check" on the card to confirm the new credentials work.
The provider uses the new credentials and the card shows the new credential source.
Troubleshooting & Failure Modes
Was this guide helpful?
Help us refine our platform documentation