API docs

Use MailThisForMe to quote and queue physical mail jobs from software workflows. The current endpoints are intentionally small while the payment, print, and mailing pipeline is still being built.

Authentication

Authenticated endpoints use bearer API keys in the Authorization header. Raw API keys are shown once when created and are stored only as hashes.

Idempotency

POST /v1/mail requires an Idempotency-Key header. Repeating the same request with the same key returns the original response; changing the payload with the same key returns a conflict.

Endpoints

• POST /v1/mail/quote accepts page_count from 1 to 10 and returns a USD quote.
• POST /v1/mail creates a queued test-mode mail job for an authenticated API key.
• GET /v1/mail/{id} returns the visible status fields for that job.
• POST /v1/mail/{id}/cancel cancels jobs while they are still queued.