flutter-mailgun's Introduction

flutter-mailgun

Send email through Mailgun API

Getting Started

Add dependency

dependencies:
  mailgun: ^0.1.0

Initialize mailer instance

import 'package:mailgun/mailgun.dart';


var mailgun = MailgunMailer(domain: "my-mailgun-domain", apiKey: "my-mailgun-api-key");

Send plain text email

var response = await mailgun.send(
  from: from,
  to: to,
  subject: "Test email",
  text: "Hello World");

Send HTML email

var response = await mailgun.send(
  from: from,
  to: to,
  subject: "Test email",
  html: "<strong>Hello World</strong>");

Send email using template and template's variables

var response = await mailgun.send(
  from: from,
  to: to,
  subject: "Test email",
  template: "my-template",
  options: {
    'template_variables': {
      'author': 'John'
    }
  });

Send email with attachments

var file = new File('photo.jpg');
var response = await mailgun.send(
  from: from,
  to: to,
  subject: "Test email",
  html: "Please check my <strong>attachment</strong>",
  attachments: [file]);

Response

Below are possible statuses of response.status:

SendResponseStatus.OK: mail is sent successfully
SendResponseStatus.QUEUED: mail is added to queue, for example, mailgun is not delivered mail immediately
SendResponseStatus.FAIL: failed to send email

In case of failure, error's message is under response.message

Recommend Projects