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

# SMTP

> Send emails using SMTP

export const FormField = ({property, label, required = false, diType, uiPatterns, children}) => {
  const patterns = Array.isArray(uiPatterns) ? uiPatterns : uiPatterns ? [uiPatterns] : [];
  return <div style={{
    margin: '1.5rem 0'
  }}>
      <div style={{
    display: 'flex',
    alignItems: 'baseline',
    flexWrap: 'wrap',
    gap: '0.5rem',
    marginBottom: '0.25rem'
  }}>
        <strong>{label}</strong>
        <span style={{
    fontSize: '0.7rem',
    fontWeight: 600,
    textTransform: 'uppercase',
    letterSpacing: '0.04em',
    color: required ? '#6241f5' : '#6b7280'
  }}>
          {required ? 'Required' : 'Optional'}
        </span>
      </div>

      <div>{children}</div>

      {diType || patterns.length > 0 ? <p style={{
    fontSize: '0.85rem',
    color: '#6b7280',
    marginBottom: 0
  }}>
          {diType ? <>
              See the <a href={`/references/${diType}`}>{diType}</a> reference.{' '}
            </> : null}
          {patterns.length > 0 ? <>
              Accepts a <a href={`/documentation/placeholders-and-patterns/patterns#${patterns[0]}`}>pattern</a>.
            </> : null}
        </p> : null}
    </div>;
};

Send emails using SMTP. This connection points Alumio at a mail server using the standard SMTP protocol, so any feature that sends mail goes out through that server. Use it when you want email delivered through your existing mail provider or company mail server rather than a hosted service. You set it up once with the server address and sign-in details, then reuse it wherever an email server is needed.

This documentation describes: [Schema](/schemas/email-server/smtp)

## Fields

<FormField property="host" label="Host" required>
  The address of your mail server, for example `smtp.example.com`. Your mail provider supplies this.
</FormField>

<FormField property="port" label="Port" required>
  The network port the mail server listens on. Common values are `587` (recommended for most servers) or `465`; your mail provider tells you which to use. The value must be between 0 and 65535.
</FormField>

<FormField property="username" label="Username" required>
  The username Alumio signs in with on the mail server. This is often the full email address of the sending account.
</FormField>

<FormField property="password" label="Password" required>
  The password for the sign-in account. Treat it like any other credential and avoid sharing it. You can reference an environment variable instead of typing the password directly.
</FormField>

## Sample data

A typical SMTP connection points at your provider's server and signs in with a sending account.

| Field    | Value                                        |
| -------- | -------------------------------------------- |
| Host     | `smtp.example.com`                           |
| Port     | `587`                                        |
| Username | `notifications@example.com`                  |
| Password | `your-password` (or an environment variable) |

```json Configuration theme={null}
{
  "prototype": "smtp",
  "parameters": {
    "host": "smtp.example.com",
    "port": 587,
    "username": "notifications@example.com",
    "password": "your-password"
  }
}
```