Configuring for Different Providers#

Sending emails from different email providers is easy. If you have your own SMTP server, you just need to set the host address, port and possibly the credentials. There are also pre-configured sender instances for common email providers:

Provider

Sender instance

Host

Port

Gmail (Google)

redmail.gmail

smtp.gmail.com

587

Outlook (Microsoft)

redmail.outlook

smtp.office365.com

587

To use them, you may need to configure the account (see below) and then you can use the sender:

from redmail import outlook
outlook.username = 'example@hotmail.com'
outlook.password = '<YOUR PASSWORD>'

outlook.send(
    subject="Example email",
    receivers=['you@example.com'],
    text="Hi, this is an email."
)

Note

Often the email providers don’t allow changing the sender address to something else than what was used to log in. Therefore, changing the sender argument often has no effect.

Note

By default, Red Mail uses STARTTLS which should be suitable for majority of cases and the pre-configured ports should support this. However, in some cases you may need to use other protocol and port. In such case, you may override the sender.port and sender.cls_smtp attributes. Read more about configuring different protocols from Configuring SMTP Client.

Gmail#

In order to send emails using Gmail, you need to:

When you have your application password you can use Red Mail’s gmail object that has the Gmail server pre-configured:

from redmail import gmail
gmail.username = 'example@gmail.com' # Your Gmail address
gmail.password = '<APP PASSWORD>'

# And then you can send emails
gmail.send(
    subject="Example email",
    receivers=['you@example.com'],
    text="Hi, this is an email."
)

Outlook#

You may also send emails from MS Outlook. To do so, you just need to have a Microsoft account. There is a pre-configured sender which you may use:

from redmail import outlook
outlook.username = 'example@hotmail.com'
outlook.password = '<YOUR PASSWORD>'

# And then you can send emails
outlook.send(
    subject="Example email",
    receivers=['you@example.com'],
    text="Hi, this is an email."
)