Skip to main content
SendPost’s Custom SMTP integration allows you to use your own SMTP server as a Third-Party Sending Provider (TPSP). This means you can:
  • Relay emails through your existing Postfix or other SMTP infrastructure
  • Receive full event visibility in SendPost (processed, sent, delivered, bounces, opens, clicks, unsubscribes)
  • Apply SendPost’s per-provider throttling (27 ISP categories), IP pool routing, and retry logic
  • View all email analytics in one centralized dashboard alongside other providers
No DNS changes are required. Your existing verified domain and bounce handling (sp-bounce.{domain}) are reused. SendPost prepares each message (DKIM, tracking pixel, click rewrites, headers) and relays it over SMTP to your server. Delivery events are captured via synchronous SMTP responses, SendPost tracking, the existing bounce processor, and an optional event reporting agent you install on your MTA.

Why Use Custom SMTP with SendPost?

FeatureYour SMTP AloneCustom SMTP + SendPost
Unified dashboard✅ All events in one place
Per-ISP throttlingManual✅ Gmail, Yahoo, etc. (27 categories)
IP pool routing✅ Route % traffic through your MTA
Retry & failoverCustom✅ Built-in retry logic, fallback to other providers
Open/click trackingCustom✅ SendPost tracking endpoints
Bounce processingCustom✅ Reuses SendPost bounce infrastructure
Gradual migration✅ Compare your MTA vs SendPost IPs side by side

What’s Covered in This Guide


Quick Reference

Key Endpoints

PurposeURL
Send EmailPOST /api/v1/subaccount/email/
Event Ingestion (agent)POST https://events.sendpost.io/api/v1/tpsp/custom-smtp/events
View EventsSendPost Dashboard → Events

Setup Checklist

1

Create Custom SMTP TPSP

In SendPost: Providers → NEW → Custom SMTP. Enter host, port, security, auth, and max rate.
2

Copy Event Ingestion API Key

Save the API key shown once after creation; it authenticates the event reporting agent.
3

Install Event Reporting Agent

Run the one-liner install on your MTA server (Postfix supported initially).
4

Configure IP Pool

Create an IP Pool in SendPost that routes traffic to your Custom SMTP TPSP.
5

Whitelist Domain

Use the same verified sending domain in SendPost that your MTA uses.
6

Send Test

Use the “Send Test” button in the UI or API with the IP pool to confirm the full pipeline.