Overview

Templates let you reuse a saved design instead of writing postcard HTML from scratch.

Use templates in the app

1. Open Templates to browse shared templates.
2. Use filters to narrow by side/category.
3. Click Use on postcard on a template card.
4. You will return to the postcard composer with that template applied.

For your own designs, use My Templates.

Use templates through the API

1. List available templates

curl "https://tinypostcard.com/api/v1/templates?scope=all&limit=20" \
  -H "Authorization: Bearer $TINYPOSTCARD_API_KEY"

scope options:

• shared: shared templates only
• mine: templates owned by the API key account
• all: both

2. Render template HTML

curl "https://tinypostcard.com/api/v1/templates/123/html?message=Greetings+from+Denver" \
  -H "Authorization: Bearer $TINYPOSTCARD_API_KEY"

Use the html value returned by this endpoint as either frontHtml or backHtml when sending.

3. Send with rendered HTML

Use POST /api/v1/postcards/send with:

• frontHtml
• backHtml
• from and to addresses

Template access rules

• You can fetch templates that are shared or owned by the API key user.
• Private templates from other users are not accessible.
• Invalid template IDs return 404.

Recommended pattern

1. Cache template IDs your workflow uses.
2. Re-render HTML right before send.
3. Send the postcard batch.