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
}

POST

api

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
}

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.

string

The letter ID.

status

string

Will be "processing" on success.

balance_cents

integer

Your remaining balance in cents after sending.

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
}

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