Postal Mail Delivery Platform Integration

Postal is a complete and fully featured mail delivery platform for use by websites and web servers. Think Sendgrid, Mailgun or Postmark but open source and ready for you to run on your own servers.

Features

This module makes it possible to send mail from Drupal using the Postal API. The functionality is provided as a MailInterface plugin.

Use the the Mail System module to configure Postal as the site default mail system or configure specific modules to use Postal as the mail system.

Requirements

• The Mail System module
• A Postal account with API credentials

Installation

Install as you would normally install a contributed Drupal module. For further information, see Installing Drupal Modules.

Configuration

Configure the module using the settings form available at /admin/config/services/postal, and select Postal Mail Delivery Platform as the default mail system for both formatter and sender or configure specific modules to use Postal Mail Delivery Platform using the Mail System configuration available at /admin/config/system/mailsystem.

Webhooks

The module provides a webhook endpoint that can be used to track mail delivery status. The endpoint is available at /postal/webhook. The endpoint is protected by a secret key that can be configured in the settings form available at /admin/config/services/postal.

When a webhook is received the module will dispatch a \Drupal\postal_mail\Event\WebhookEvent event that can be subscribed to in custom code. The event contains the payload as specified in the Postal API documentation.

It is also possible to use the Webhooks module if you want a more "site builder" friendly way to configure and work with webhooks.