ServerpodCloudEmailIdpConfig class

An EmailIdpConfig that works with Serverpod Cloud without configuration.

In development and test run mode, verification codes are logged to the console via Session.alert — the same behavior as the default development setup. In staging and production run mode, emails are sent through the hosted Serverpod Cloud transactional email service (see ServerpodCloudEmailClient).

The staging/production setup reads the scloudAuthEmailKey password, which is provided automatically by Serverpod Cloud. The key is read lazily when an email is sent (not at startup), so a self-hosted server still boots when it is unset. Sending is best-effort: a failure (outage, missing key, non-200, or timeout) is logged and never propagated, so it neither breaks sign-up nor reveals whether an account exists during password reset.

If you want to send emails through a custom provider instead, use EmailIdpConfigFromPasswords.

This requires that a Serverpod instance has already been initialized, as it reads the emailSecretHashPepper password from the passwords.yaml file.