Postmark API library for python 2.6, 2.7, 3.x and pypy. Built on top of the requests library.

The full Sphinx-compiled documentation is available here: https://readthedocs.org/docs/pystmark/en/latest/

import pystmark

API_KEY = 'my_api_key'
SENDER = '[email protected]'

# Send a single message
message = pystmark.Message(sender=SENDER, to='[email protected]', subject='Hi',
                           text='A message', tag='greeting')
pystmark.send(message, api_key=API_KEY)


# Send multiple messages (via Postmark's batch send API)
recipients = ['you{0}@example.com'.format(i) for i in xrange(20)]
messages = [pystmark.Message(sender=SENDER, to=to, subject='Hi',
                             text='A message', tag='greeting')
            for to in recipients]

response = pystmark.send_batch(messages, api_key=API_KEY)

# Check API response error
try:
    response.raise_for_status()
except pystmark.UnauthorizedError:
    print 'Use your real API key'

1. Fork this repo
2. Make your changes and write a test for them
3. Add yourself to the AUTHORS file and submit a pull request

Please run the tests with ./setup.py test --with-integration, with at least python2.7, before you make a pull request. Requirements for running the tests are in tests/requirements.txt. The other versions will be handled by travis-ci.

The pep8 tests may fail if using pypy due to this bug, so that test is disabled if pypy is detected.

If you would like to integrate this with some web framework, write a separate module and I'll link to it from here.

pystmark is licensed under the MIT license. See the LICENSE file for full details.