v1 API

Posthawk API Documentation

Everything you need to send, schedule, and manage emails programmatically.

Quick Start

bash

curl -X POST https://your-instance.com/v1/send \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": ["user@example.com"],
    "subject": "Hello from Posthawk",
    "html": "<h1>It works!</h1>"
  }'

Introduction

Posthawk is an open-source email platform built for developers. Send transactional emails, schedule deliveries, manage templates, and handle inbound email — all through a simple REST API.

Posthawk provides a complete email infrastructure:

• Transactional email sending via AWS SES
• Email templates with variable substitution
• Scheduled email delivery with timezone support
• Inbound email processing via Cloudflare or AWS SNS
• Rate limiting and reputation monitoring
• API key management for secure access

Base URL: https://your-posthawk-instance.com

Cloud (managed) users: your base URL is https://api.posthawk.dev

Authentication