/ 
Mojo-Sendgrid-0.05
River stage zero No dependents
/ Mojo::Sendgrid

NAME

Mojo::Sendgrid - Sendgrid API implementation for the Mojolicious framework

VERSION

0.05

SYNOPSIS

use Mojo::Sendgrid;

my $sendgrid = Mojo::Sendgrid->new(
                 config => {
                   apikey => 'get your key from api.sendgrid.com',
                   #apiurl => 'you do not need to set this',
                 },
               );

$sendgrid->on(mail_send => sub {
  my ($sendgrid, $ua, $tx) = @_;
  say $tx->res->body;
});

say $sendgrid->mail(
  to      => q(a@b.com),
  from    => q(x@y.com),
  subject => time,
  text    => time
)->send;

Mojo::IOLoop->start;

DESCRIPTION

Mojo::Sendgrid is an implementation of the Sendgrid API and is non-blocking thanks to Mojo::IOLoop from the wonderful Mojolicious framework.

It currently implements the mail endpoint of the Web API v2.

This class inherits from Mojo::EventEmitter.

EVENTS

Mojo::Sendgrid inherits all events from Mojo::EventEmitter and can emit the following new ones.

mail_*

See <Mojo::Sendgrid::Mail> for full list

ATTRIBUTES

config

Holds the configuration hash.

apikey

Accesses the apikey element of "config". Can be overridden by the environment variable SENDGRID_APIKEY. This attribute is required to have a value.

apiurl

Accesses the apiurl element of "config". Can be overridden by the environment variable SENDGRID_APIURL. This attribute by default uses the Web API v2 URL documented by Sendgrid.

METHODS

mail

$self = $self->mail(%args);

The mail endpoint of the Sendgrid Web API v2.

COPYRIGHT

This program is free software, you can redistribute it and/or modify it under the terms of the Artistic License version 2.0.

AUTHOR

Stefan Adams - sadams@cpan.org