Help Center/Admin Operations/How to add an SMTP provider configuration
Admin Operations•Last updated: 2026-10-20•3 min read

How to add an SMTP provider configuration

Fill in the "Add an SMTP provider configuration" form to register a mail server for an environment.

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

Ask AI Copilot

Step-by-Step Procedure

1

Open the form

On /admin/communications/email-engine/providers scroll to "Add an SMTP provider configuration".

2

Enter identity and server

"Display name" (required), "Environment" (development, staging or production; default production), "SMTP host" (required), "Port" (default 587).

3

Enter sender details

"From address" (required email), "From display name" and "Reply-to" (both optional).

4

Set limits

"Rate limit / minute (optional)", "Max attempts" (default 5) and "Retry base delay (ms)" (default 30000).

5

Set the toggles

Tick "TLS (secure)" if the server needs TLS, "Default for this environment" (ticked by default) and "Enabled" (ticked by default).

6

Choose credentials

See the credentials guide, then click "Create provider configuration". A green message reads Created "<display name>". and the form resets.

Expected Operational Outcome

The new configuration appears under "Configured providers" as "Unverified" until you run a health check.

Troubleshooting & Failure Modes

Symptom: A red message appears under the header after clicking create
Likely Cause: The server rejected the request (authorisation or validation); the message text is shown as returned.
Resolution: Correct the field named in the message and submit again.

Was this guide helpful?

Help us refine our platform documentation