Save and verify email transport settings
Builds candidate email delivery settings, sends a real verification email to from_address and saves only after successful delivery and a concurrent-change check. Custom SMTP host, login and password must be complete together. Omitted settings preserve saved values; clear_mailgun removes the custom transport. Provider verification failures include EMAIL_DELIVERY_VERIFICATION_FAILED, attempted_transport and responsibility. Requires permission: one of manage_email, access_account_settings.
Authorizations
Passport bearer token authentication for legacy admin sessions.
Body
Validated request fields for this operation.
"support@example.org"
Sender display name; required by the handler.
"Example Nonprofit"
255"smtp.example.org"
255"postmaster@example.org"
Nonblank values replace the saved secret; blank/omitted values preserve it unless clear_mailgun is true.
1024"REDACTED"
Optional saved Mailgun API key; blank/omitted values preserve it unless clearing.
1024"REDACTED"
1 <= x <= 65535587
32"tls"
Clears saved custom delivery configuration and verifies default delivery.
false
Response
Operation result.
"Settings saved successfully."