Official Go SDK
Postscale now has an official Go SDK:
github.com/postscale/postscale-go.
- Go 1.21+ support. The module uses the standard library for its HTTP core
and accepts
context.Contexton every network operation. - Typed public API resources. The first release covers email sending, domains, DKIM, aliases, inbound email, stats, warming, suppressions, webhooks, templates, usage, and trust review.
- Safe request behavior. Automatic retries are limited to idempotent methods. Email sends and other mutations are never replayed automatically.
- Operational diagnostics. Successful responses and
APIErrorvalues expose request IDs, retry timing, HTTP headers, and raw error bodies. - Attachment support. Helpers encode and validate outbound attachments,
while inbound attachment downloads stream through an
io.ReadCloser. - Webhook verification. The SDK verifies timestamped
X-Postscale-Signatureheaders, including multiple signatures and secrets during rotation windows.
Install it with:
go get github.com/postscale/postscale-go@latest
Start with the SDKs and HTTP Clients guide, then use Sending Emails and Webhooks for production examples.
This release covers public product APIs only. Billing, invoices, onboarding, browser auth, MFA, API-key management, admin routes, Stripe webhooks, unsubscribe endpoints, and contact forms are intentionally excluded.