Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Django utilities to help track emails sent using Postmark

Project description

# Django Postmark Utils

Django utilities to help track emails sent using Postmark.

## Features

- Store emails (including failed attempts) sent from within your project
- Receive and store webhook notifications, for email bounces and deliveries
- Track sent emails for errors, bounces, and deliveries
- Resend emails

## Prerequisites

- [Django](https://www.djangoproject.com/)
- [Postmark](https://postmarkapp.com/) account

## Installation

```
$ pip install git+https://github.com/regulusweb/django-postmark-utils.git
```

Django Postmark Utils makes use of the Django email backend provided by [Postmarker](https://postmarker.readthedocs.io/en/latest/), so first configure it in your project's settings, as per the [documentation](https://postmarker.readthedocs.io/en/latest/django.html).

```python
EMAIL_BACKEND = 'postmarker.django.EmailBackend'
POSTMARK = {
'TOKEN': '<YOUR POSTMARK SERVER TOKEN>',
'TEST_MODE': False,
'VERBOSITY': 0,
}
```

Add the app to your project's `INSTALLED_APPS` setting:

```python
INSTALLED_APPS = (
'django_postmark_utils',
)
```

Create the required database tables:

```
$ python manage.py migrate django_postmark_utils
```

To receive [bounce](https://postmarkapp.com/developer/webhooks/bounce-webhook) and [delivery](https://postmarkapp.com/developer/webhooks/delivery-webhook) [webhook notifications](https://postmarkapp.com/developer/webhooks/webhooks-overview) from Postmark, configure the webhook URLs in your project's URL configuration:

```python
urlpatterns = [
url(r'^postmark/', include('django_postmark_utils.urls')),
]
```

In your project's settings, configure a secret to be added to the webhook URLs:

```python
POSTMARK_UTILS_SECRET = '<YOUR WEBHOOK URLS SECRET>'
```

Add the webhook URLs to your Postmark account:

`https://example.com/postmark/<YOUR WEBHOOK URLS SECRET>/bounce-receiver/`
`https://example.com/postmark/<YOUR WEBHOOK URLS SECRET>/delivery-receiver/`

Optionally change the default email header field name (`X-DjangoPostmarkUtils-Resend-For`) used to match resent emails to the messages they are for, in your project's settings:

```python
MESSAGE_ID_HEADER_FIELD_NAME = '<YOUR CUSTOM EMAIL HEADER FIELD NAME>'
```

## Usage

Emails (including failed attempts) sent via the Postmarker email backend will be stored in the database, and can be viewed in the admin.

In the email change page, clicking on the `Go to resend list` link next to the `Resend` field will send you to a list from where you can use the `Resend emails` admin action to resend the email.


Project details


Release history Release notifications

This version
History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django_postmark_utils-0.1-py3-none-any.whl (17.4 kB) Copy SHA256 hash SHA256 Wheel py3 Feb 9, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page