---
name: "Email::Sender::Transport::SMTP::TLS"
section: "3pm"
platform: "linux"
package: "libemail-sender-transport-smtp-tls-perl"
version: "0.15-1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/Email::Sender::Transport::SMTP::TLS"
---

# Email::Sender::Transport::SMTP::TLS(3pm)

Email::Sender with Net::SMTP::TLS (Eg. Gmail)

## NAME

Email::Sender::Transport::SMTP::TLS - Email::Sender with Net::SMTP::TLS (Eg. Gmail)

## VERSION

version 0.15

## SYNOPSIS

```
    use Email::Sender::Simple qw(sendmail);
    use Email::Sender::Transport::SMTP::TLS;
    use Try::Tiny;
    my $transport = Email::Sender::Transport::SMTP::TLS->new(
        host => 'smtp.gmail.com',
        port => 587,
        username => 'username@gmail.com',
        password => 'password',
        helo => 'fayland.org',
    );
    # my $message = Mail::Message->read($rfc822)
    #         || Email::Simple->new($rfc822)
    #         || Mail::Internet->new([split /\n/, $rfc822])
    #         || ...
    #         || $rfc822;
    # read L<Email::Abstract> for more details
    use Email::Simple::Creator; # or other Email::
    my $message = Email::Simple->create(
        header => [
            From    => 'username@gmail.com',
            To      => 'to@mail.com',
            Subject => 'Subject title',
        ],
        body => 'Content.',
    );
    try {
        sendmail($message, { transport => $transport });
    } catch {
        die "Error sending email: $_";
    };
```

## DESCRIPTION

**If you have never used it before, please try Email::Sender::Transport::SMTPS instead. it's recommended.**

Email::Sender replaces the old and sometimes problematic Email::Send library, while this module replaces the Email::Send::SMTP::TLS.

It is still alpha, but it works. use it at your own risk!

### ATTRIBUTES

The following attributes may be passed to the constructor:

- host - the name of the host to connect to; defaults to localhost

  - port - port to connect to; defaults to 587

  - username - the username to use for auth; required

  - password - the password to use for auth; required

  - helo - what to say when saying HELO; no default

  - allow\_partial\_success - if true, will send data even if some recipients were rejected

  ### PARTIAL SUCCESS

If `"allow_partial_success"` was set when creating the transport, the transport may return Email::Sender::Success::Partial objects.  Consult that module's documentation.

## AUTHOR

Fayland Lam \<fayland@gmail.com\>

## COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Fayland Lam.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
