python-mailgun3's Introduction

python-mailgun3

A super simple Python API for interacting with Mailgun. Currently only supports sending messages. Powered by Requests.

Python 3 support should be there but is currently untested.

Installation:

pip install mailgun3

Usage:

from mailgun2 import Mailgun
mailer = Mailgun('apikey', 'example.mailgun.org')
mailer.send_message(
    '[email protected]',
    ['[email protected]', '[email protected]'],
    subject='Hi!',
    text='Sweet.'
    )

Required arguments:

from_email: string of email address to set as sender
to: list or string of email address to send to

Optional arguments:

subject: string subject of the email
text: string body of the email. Either text or html is required.
html: string HTML of the email. Either text or html is required.
cc: list of cc addresses.
bcc: list of bcc addresses.
tags: list of mailgun tags to associate with the email.
reply_to: Convenience argument for setting the Reply-To header
headers: Extra headers for messages
inlines: List of file paths to attach inline to the message
attachments: List of (file name, content type, file handle) as a multipart attachment

Pull requests welcome!

Recommend Projects