Skip to main content
POST
/
api
/
v1
/
letters
/
{letterId}
/
send
curl -X POST https://thepostalcompany.com/api/v1/letters/a1b2c3d4-e5f6-7890-abcd-ef1234567890/send \
  -H "Authorization: Bearer tpc_your_api_key"
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing",
  "balance_cents": 750
}

Documentation Index

Fetch the complete documentation index at: https://docs.thepostalcompany.com/llms.txt

Use this file to discover all available pages before exploring further.

Send a Draft

Send a letter that is currently in draft status. This deducts your balance and queues the letter for printing and delivery.

Path parameters

letterId
string
required
The unique letter ID of the draft to send.

Response

id
string
The letter ID.
status
string
Will be "processing" on success.
balance_cents
integer
Your remaining balance in cents after sending.

Examples

curl -X POST https://thepostalcompany.com/api/v1/letters/a1b2c3d4-e5f6-7890-abcd-ef1234567890/send \
  -H "Authorization: Bearer tpc_your_api_key"
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing",
  "balance_cents": 750
}

Error codes

StatusDescription
400Letter is missing required content or address
401Missing, invalid, or revoked API key
402Insufficient balance
404Letter not found or does not belong to your account
409Letter is not in draft status