PING8 SDKs
Official SDK documentation for PING8, powered by WorkOnward.
Use the SDKs to queue email through the public PING8 Send API without hand-rolling HTTP clients, request validation, response parsing, or retry policy.
Supported SDKs
| Language | Package | Runtime |
|---|---|---|
| Python | workonward | Python 3.9+ |
| TypeScript | @workonward/sdk | Node 18+ and browser fetch |
| Go | github.com/rahvis/email/SDK/go | Go 1.21+ |
| Rust | workonward | Rust 1.75+, async reqwest |
| MCP Server | workonward-mcp | Python 3.11+, MCP clients |
API Defaults
All SDKs default to:
https://mail.gitdate.inkYou can also pass https://mail.gitdate.ink/api. The SDKs normalize both values to the public routes:
/api/batch_mail/api/send
/api/batch_mail/api/batch_sendProduction Defaults
- API keys are read from
WORKONWARD_API_KEYin examples. - Retries are off by default because send requests do not currently have idempotency keys.
- Batch sends reject the whole batch if any recipient address is invalid.
- Exceptions include structured context such as server code, HTTP status, response data, and safe response text where the language supports it.
- The MCP server starts in dry-run mode and denies sends until a recipient allowlist is configured.
Before You Send
Create a Send API key in PING8, keep the key out of source code, and verify your sending domain before sending to real recipients.
Start with Quickstart, then open the language or MCP Server page for your application.