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

# Send program emails with SMTP

> Connect any email provider's SMTP server to send your program's emails from your own domain

SMTP lets Partnero send your program's emails through any email provider that offers SMTP access, such as your
company mail server, Microsoft 365, Amazon SES or Zoho Mail. Your emails then go out from your own domain, such
as *[partners@yourdomain.com](mailto:partners@yourdomain.com)*, instead of the default *@partnero.email* address.

> [!TIP]
>
> If your provider is [MailerSend](https://docs.partnero.com/integrations/mailersend.md), [Brevo](https://docs.partnero.com/integrations/send-program-emails-with-brevo.md),
> [Mailgun](https://docs.partnero.com/integrations/mailgun.md), [Postmark](https://docs.partnero.com/integrations/postmark.md), [SendGrid](https://docs.partnero.com/integrations/sendgrid.md) or
> [Gmail](https://docs.partnero.com/knowledge-base/program-emails/send-program-emails-with-gmail.md), connect it directly instead. You only
> need an API key or a sign-in, not SMTP credentials.

## Before you start

Get these SMTP details from your email provider:

* **Server**: the SMTP host name, for example `smtp.yourprovider.com`.
* **Port** and **security**: usually port `587` with TLS, or port `465` with SSL.
* **Username** and **password**: many providers require an app password or SMTP-specific password rather than
  your regular sign-in password.
* **From email address**: the address your emails will come from. Your provider must allow sending from it.

## Connect SMTP

1. In your program, go to **Emails** under Affiliate.
2. On the **Settings** tab, click **Setup** next to **Use custom SMTP**:

   ![Email settings with the Setup button next to Use custom SMTP](https://mintcdn.com/partnero/bKRQc1avHhyQ2pI4/images/image-164.png?fit=max\&auto=format\&n=bKRQc1avHhyQ2pI4\&q=85\&s=a2c2e6727fe1a4a7fb64e45931b5aeaa)
3. Under **Server**, enter the host name and the port, then choose the security type:
   * **TLS** or **SSL**: use the one your provider documents for the port you entered.
   * **None**: only for servers that don't use encryption. Username and password are optional with this
     setting.
   * **Auto**: Partnero tries TLS on port `587`, then SSL, and keeps the first one that connects. The port you
     entered is not used.
4. Enter your **Username** and **Password**.
5. Enter your **From email address**.
6. Click **Connect**.

Partnero connects and signs in to your SMTP server to check the details. Once connected, **Use custom SMTP**
shows a green checkmark.

## Choose your sender

Connecting SMTP does not change which address your emails come from.

1. Under **Sender email**, open the domain list and pick your domain from the **SMTP domains** group. The domain
   comes from the **From email address** you entered, so it only appears if you entered one.
2. Check the field before the **@**. If your SMTP username is an email address, the part before its **@** is
   filled in for you. You can change it, as long as your provider allows sending from that address.
3. Click **Update** to save.

> [!TIP]
>
> Click **Send test email** below the email gateways to confirm everything works before your partners start
> receiving emails.

## Disconnecting

Click **Setup** next to **Use custom SMTP**, then click **Disconnect**. Your SMTP details are removed from
Partnero.

If SMTP was sending your program's emails, your sender email switches back to Partnero's default
*@partnero.email* address, so your emails keep going out. To change any SMTP details, disconnect and connect
again with the new details.

## Troubleshooting

> [accordion] Connecting fails or times out
>
> Check the server name and port with your provider, then choose the matching security type instead of
> **Auto**. Port `587` usually uses TLS and port `465` usually uses SSL. Your server must also accept
> connections from outside your network, because Partnero connects to it over the internet.

> [accordion] Authentication fails
>
> Make sure the username and password are your SMTP credentials. Many providers, including Microsoft 365 and
> Zoho Mail, need SMTP sending turned on for the mailbox or an app password instead of your regular password.

> [accordion] The SMTP domain is not in the Sender email list
>
> The domain comes from your **From email address**. Disconnect SMTP and connect again with a From email
> address filled in.

> [accordion] Connecting works but test emails fail
>
> Your provider may only allow sending from addresses it knows about. Make sure the sender email matches an
> address or domain your provider allows, and check your provider's sending limits.

## Next steps

> [card] [Email settings](https://docs.partnero.com/knowledge-base/program-emails/email-settings.md)
>
> Compare every email gateway you can connect

> [card] [Program emails](https://docs.partnero.com/knowledge-base/getting-started/program-email-notifications.md)
>
> Which emails Partnero sends


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.