> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oviond.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SMTP

> Route Oviond email through your own SMTP server.

By default Oviond sends email through its managed provider. If you need every email to pass through your own SMTP server — for deliverability isolation, audit, or IP warming — configure SMTP under **Settings → Email settings** (`/settings/email-settings`). Saving an SMTP config makes SMTP your active email provider.

## Configure

<Steps>
  <Step title="Open Email settings">
    Go to **Settings → Email settings** and set up SMTP (via **Set up SMTP**, or **Add Sender → SMTP server**).
  </Step>

  <Step title="Enter your server details">
    Provide the **SMTP host**, **port** (default `587`), **username**, and **password**, plus the **from email** and an optional **from name**. Leave **Use TLS/SSL** checked unless your server requires otherwise.
  </Step>

  <Step title="Save">
    Oviond tests the connection, then — if it succeeds — stores the password encrypted at rest and switches the account's active provider to SMTP.
  </Step>
</Steps>

## Fields

| Field        | Notes                                                                                                                                                                       |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `host`       | SMTP server hostname.                                                                                                                                                       |
| `port`       | Server port. Most servers use `587` (STARTTLS); `465` uses implicit TLS.                                                                                                    |
| `username`   | SMTP auth username.                                                                                                                                                         |
| `password`   | SMTP auth password. Stored encrypted and never returned by the API.                                                                                                         |
| `secure`     | Whether to connect over TLS. The server derives this from the port — `465` uses implicit TLS; `587`/`25` upgrade via STARTTLS — regardless of the **Use TLS/SSL** checkbox. |
| `from_email` | The default from-address for SMTP sends.                                                                                                                                    |
| `from_name`  | Optional display name.                                                                                                                                                      |

## Connection test

Oviond tests the connection as part of saving — there's no separate test button. When you save, it connects to the server and verifies your credentials without sending an email; if the test fails, the save is aborted and the error (usually auth, TLS, or firewall related) is shown inline.

## Remove SMTP

Deleting the SMTP config removes its credentials and cascade-deletes any senders tied to SMTP. If SMTP was the active provider, Oviond falls back to the Oviond provider.

<Warning>
  A misconfigured SMTP server stops email from delivering. Because the save aborts on a failed connection test, a stored config has already passed the test — but verify deliverability with a real send before relying on it for client email.
</Warning>