Email

The **Email** panel configures SMTP settings so AI Experts (like Postman) can send emails on your behalf. Without this, email-related features won't work.

![Settings — Email / SMTP](https://assets.yaoagents.com/en/settings/09-config-email-en-$__THEME.png)

## Configuration

| Field | Description |
|-------|-------------|
| Provider | Select a preset or choose Custom for other SMTP servers. |
| SMTP Host | The mail server address. Auto-filled when you select a preset provider. |
| SMTP Port | The port number (typically 587 for TLS, 465 for SSL). Auto-filled with preset. |
| Encryption | SSL or TLS. Auto-filled with preset. |
| Username | Your email account username (usually your full email address). |
| Password | Your email password or app-specific password. |
| Sender | The "From" address that recipients will see. |

## Available presets

| Provider | Host | Port | Encryption | Notes |
|----------|------|------|------------|-------|
| Gmail | smtp.gmail.com | 465 | SSL | Requires an [App Password](https://myaccount.google.com/apppasswords), not your login password. |
| Yahoo Mail | smtp.mail.yahoo.com | 465 | SSL | Requires an App Password from [account security](https://login.yahoo.com/account/security). |
| SendGrid | smtp.sendgrid.net | 587 | TLS | Username is always `apikey`, password is your API Key. |
| Mailgun | smtp.mailgun.org | 587 | TLS | Get SMTP credentials from [Mailgun dashboard](https://app.mailgun.com/). |
| Amazon SES | email-smtp.us-east-1.amazonaws.com | 587 | TLS | Create SMTP credentials in [AWS SES console](https://console.aws.amazon.com/ses/), not IAM keys. |
| Custom | (you fill in) | 465 | SSL | Manually enter SMTP server details. |

## Gmail setup

Gmail requires an **App Password** instead of your regular password:

1. Go to [myaccount.google.com/apppasswords](https://myaccount.google.com/apppasswords).
2. Select **Mail** as the app and your device type.
3. Click **Generate** and copy the 16-character password.
4. In Yao Agents, select **Gmail** as the provider.
5. Enter your Gmail address as both **Username** and **Sender**.
6. Paste the App Password into the **Password** field.
7. Click **Save**.

## SendGrid setup

1. Select **SendGrid** as the provider.
2. Enter `apikey` as the **Username**.
3. Paste your SendGrid API Key as the **Password**.
4. Enter your verified sender email as **Sender**.
5. Click **Save**.

## Custom SMTP

For other email services, select **Custom** and fill in all fields manually. Check your email provider's documentation for the correct SMTP host, port, and encryption method.