Base URL

https://tinypostcard.com

Authentication

Create an API key from Integrations, then pass it on every request:

curl -X GET "https://tinypostcard.com/api/v1/me" \
  -H "Authorization: Bearer tpc_live_xxx"

You can also use x-api-key: tpc_live_xxx.

Core workflow

1. Create account and buy tokens on Billing.
2. Generate an API key on Integrations.
3. Search or fetch templates.
4. Render HTML from templates (or provide your own HTML).
5. Send postcards with frontHtml and backHtml.

Endpoint groups

Identity and billing

• GET /api/v1/me
• GET /api/v1/balance
• GET /api/v1/token-packs

Templates

• GET /api/v1/templates
• GET /api/v1/templates/{templateId}
• GET /api/v1/templates/{templateId}/html

Postcards

• POST /api/v1/postcards/send

Admin (admin API key only)

• GET /api/v1/admin/token-packs
• GET /api/v1/admin/users
• GET /api/v1/admin/users/{userId}/token-balance

Next steps

• Start with API Overview
• Review Postcards endpoint
• Install the tinypostcard skill