Email Infrastructure
Engineering2 min read

Email Sending Credentials: Rotation and Offboarding

A provider-neutral runbook for inventorying, rotating, testing, revoking, and offboarding SMTP passwords, API keys, and roles.

RT
RepMail Team

Product & Engineering · September 25, 2026 · 2 min read

Email sending credentials include SMTP passwords, API keys, IAM roles, service accounts, and provider-console access. Treat them as a lifecycle: inventory, scope, issue, test, rotate, revoke, and review. The objective is to reduce unauthorized sending and make each action attributable without publishing or copying a live secret.

Inventory before changing

Create a record for every credential identifier, owner, provider account, environment, permission scope, storage location, last use, last rotation, and dependent application. Include shared admin accounts and break-glass access. Link each credential to the message stream and event destination it controls. Email-sending observability helps reveal which identifiers and states need to remain traceable.

Rotate with overlap and verification

Create the replacement with the narrowest practical permissions. Store it in the approved secret manager and deploy it through the normal release path. If the provider supports two active credentials, use a short, documented overlap: deploy the new credential, send a controlled test, check provider acceptance and downstream events, then revoke the old one. If overlap is not available, schedule a maintenance window and keep a rollback credential protected rather than leaving the old key active indefinitely.

Test the actual path, not just authentication. Confirm the application can enqueue mail, receives provider responses, records message identifiers, handles retries, and processes bounce or complaint events. A successful login does not prove the whole send and feedback loop works. Record timestamps and results; do not use invented universal thresholds.

Offboard people, vendors, and tenants

When an operator or vendor leaves, identify their direct credentials, delegated roles, shared accounts, webhooks, CI variables, provider consoles, and recovery addresses. Transfer ownership before revocation. Reconcile recent send events and suppressions so an integration cannot be silently re-enabled. For a suspected compromise, preserve logs, pause the affected path, rotate related secrets, and communicate the scope to the incident owner.

Governance controls

Use dual control for high-blast-radius changes, least privilege for applications, periodic access reviews, immutable or access-controlled audit logs, and a documented break-glass procedure. The platform selection guide is useful when a provider cannot express the isolation or audit controls your team requires.

Related resources

See the Email Infrastructure academy for the wider sending architecture.

This workflow should be checked against the cited standards and current provider documentation 1.

References

Resources in this guide

Credential lifecycle checklist
Checklist
    security
    credentials
    smtp
    api

    Frequently asked questions

    How often should sending credentials be rotated?

    Set a policy based on credential type, exposure, provider capabilities, and risk. Rotate immediately after suspected exposure or ownership change, and record the rationale.

    Is a shared SMTP account acceptable?

    It weakens attribution and offboarding. If it cannot be avoided, restrict its scope, protect it as a service secret, log use, and document a migration to individually attributable credentials.

    What proves a rotation succeeded?

    A controlled send through the real application path, expected provider response, downstream event processing, and successful revocation or failure detection for the old credential.

    Continue learning

    Instrument send and provider events

    Continue with the closest operational guide.

    More on this topic