Certified Mail API
This page is for software developers. To send a letter yourself, open the sending form.
Use the API to quote, draft and track US domestic Certified Mail, with or without an electronic Return Receipt. Send a PDF or typed text. We print and mail the letter after payment and screening.
Get a quote
No API key is needed for quotes. This example returns an itemized one-page quote in US cents before any applicable sales tax.
curl https://certifiedmailsender.com/v1/quotes \
-H 'Content-Type: application/json' \
--data '{"service":"certified","pages":1}'Create a test draft
Sign in to your account and create a test API key. Set CMS_TEST_KEY to that key. Send your key as Authorization: Bearer <key>. Test letters never mail.
Set CMS_IDEMPOTENCY_KEY to a new UUID for each new letter. When retrying a request, reuse its key and body.
curl https://certifiedmailsender.com/v1/letters \
-H "Authorization: Bearer $CMS_TEST_KEY" \
-H "Idempotency-Key: $CMS_IDEMPOTENCY_KEY" \
-H 'Content-Type: application/json' \
--data-binary @- <<'JSON'
{
"service": "certified",
"to": {
"name": "Jordan Lee",
"line1": "500 Market St",
"line2": "Suite 200",
"city": "Philadelphia",
"state": "PA",
"zip": "19106"
},
"from": {
"name": "Sam Ortiz",
"line1": "12 Oak Ave",
"city": "Columbus",
"state": "OH",
"zip": "43215"
},
"text": "Dear Jordan,\n\nThis is a test letter."
}
JSONApproval and payment
For a regular draft, share its private approval_url with the person sending the letter. They review the letter, addresses and price, then approve and pay. A trusted auto-send key pays from prepaid balance after the address check, without per-letter approval. Screening still runs before printing.
API and MCP reference
Read the full OpenAPI specification for request and response fields. Connect an assistant to https://certifiedmailsender.com/mcp or see the assistant setup guide.