Postal Mail Delivery Platform Integration
This module allows Drupal to send emails using the Postal mail delivery platform. It integrates with Drupal's mail system to let you configure Postal as your default email sender and can track email delivery status via webhooks.
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.