/ 
Mail-SendGrid-0.09
River stage zero No dependents
/ Mail::SendGrid::Bounce

NAME

Mail::SendGrid::Bounce - data object that holds information about a SendGrid bounce

VERSION

version 0.09

SYNOPSIS

use Mail::SendGrid::Bounce;

$bounce = Mail::SendGrid::Bounce->new(
                    email   => '...',
                    created => '...',
                    status  => '...',
                    reason  => '...',
                   );

DESCRIPTION

This class defines a data object which is returned by the bounces() method in Mail::SendGrid. Generally you won't instantiate this module yourself.

METHODS

email

The email address you tried sending to, which resulted in a bounce back to SendGrid.

created

Date and time in ISO date format. I'm assuming this is the timestamp for when the bounce was received back at SendGrid.

status

A string which identifies the type of bounce. At the moment my understanding is that this will either be the string '4.0.0' for a soft bounce, and '5.0.0' for a hard bounce. I'm trying to get confirmation or clarification from SendGrid.

reason

The reason why the message bounced; typically this is the reason returned by the remote MTA. Sometimes the reason string will start with the SMTP response code; I'm trying to find out from SendGrid in what situations that isn't true.

SEE ALSO

SendGrid API documentation

http://docs.sendgrid.com/documentation/api/web-api/webapibounces/

AUTHOR

Neil Bowers <neilb@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Neil Bowers <neilb@cpan.org>.

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