Postmark Setup

Connect your Postmark account to Optail.

Prerequisites

• A Postmark account
• A verified sending domain or sender signature in Postmark

1. Get Your Server Token

1. Log in to the Postmark dashboard
2. Select your Server (or create one)
3. Go to Settings > API Tokens
4. Copy the Server API Token

The Server Token is scoped to a single server and is used for sending emails. Do not use your Account API Token.

2. Connect in Optail

Via Dashboard

1. Go to Providers > Connect Provider
2. Select Postmark
3. Enter a display name (e.g., "Postmark Transactional")
4. Paste your Server Token
5. Click Connect -- Optail validates by calling Postmark's server info endpoint

Via API

curl -X POST https://api.optail.io/v1/providers \
  -H "Authorization: Bearer ms_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "providerType": "POSTMARK",
    "displayName": "Postmark Transactional",
    "credentials": {
      "serverToken": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
  }'

3. Verify Your Sending Domain

1. In Postmark, go to Sender Signatures > Add Domain
2. Add your sending domain
3. Add the required DNS records (DKIM via CNAME, Return-Path via CNAME)
4. Click Verify once DNS records propagate

Postmark requires either a verified domain or a verified sender signature before you can send.

4. Configure Webhooks (Optional)

To receive delivery events in Optail:

1. In Postmark, go to your Server > Settings > Webhooks
2. Click Add webhook
3. Set the Webhook URL to: https://webhooks.optail.io/v1/ingest/postmark
4. Select the events: Delivery, Bounce, Spam Complaint, Open, Click
5. Save the webhook

Credential Reference

Field	Description
serverToken	Postmark Server API Token (UUID format).