postmark-webhooks

Process Postmark webhook events across Express, Next.js, and FastAPI.

79|11|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/hookdeck/webhook-skills --skill postmark-webhooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: postmark-webhooks
Source: https://github.com/hookdeck/webhook-skills/tree/main/skills/postmark-webhooks
Command: npx skills add https://github.com/hookdeck/webhook-skills --skill postmark-webhooks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a ready-to-use blueprint for receiving and processing Postmark webhook events across major runtimes, enabling real-time handling of email events such as Bounce, Delivery, Open, Click, SpamComplaint, and SubscriptionChange.

Core Features & Use Cases

  • Cross-runtime webhook handling: Templates and examples for Express, Next.js, and FastAPI to cover common backend stacks.
  • Payload validation: Ensures essential fields like RecordType and MessageID are present before processing.
  • Secure authentication guidance: Clear guidance for token-based or basic authentication to protect webhook endpoints.
  • On-demand event routing: Routes events to framework-specific handlers with structured logging and error handling.
  • Local development & testing: Includes guidance and patterns to test webhooks locally using tooling like Hookdeck.

Quick Start

Start by configuring your webhook in Postmark to point to your endpoint (using token or basic auth), then choose an example framework (Express, Next.js, or FastAPI), set up the environment, and run the server to begin processing incoming webhooks.

Frequently Asked Questions about postmark-webhooks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle Postmark webhooks in Express or FastAPI?

Handle Postmark webhooks by setting up endpoint routes in Express, Next.js, or FastAPI that receive event payloads, validate required fields like RecordType and MessageID, and route them to specific handlers for processing.

What Postmark webhook events should my endpoint validate?

Your Postmark webhook endpoint should validate payloads containing RecordType and MessageID fields to reliably process Bounce, Delivery, Open, Click, SpamComplaint, and SubscriptionChange events before routing them to handlers.

How do I authenticate incoming Postmark webhook requests?

Authenticate Postmark webhook requests using token-based or basic authentication configured within your Express, Next.js, or FastAPI endpoint to secure your webhook URL against unauthorized access.

Can I test Postmark webhooks locally during development?

You can test Postmark webhooks locally using webhook tooling like Hookdeck to forward events to your local development server, enabling real-time debugging of payload validation and event routing.

What is the best way to route Postmark bounce and open events to different handlers?

The best way to route Postmark bounce and open events is to implement framework-specific handlers that parse the RecordType field from the validated payload and dispatch events consistently with structured logging.

Why does my Postmark webhook endpoint fail to process incoming events?

Postmark webhook endpoints fail to process incoming events when payloads lack required structure like RecordType and MessageID fields, or when authentication tokens are mismatched between Postmark and your server.