Docs menu

Templates

Templates keep wording and layout in one place. Flinkk Mail includes 21 built-in templates in three groups, and you can make your own copy of any of them or write one from scratch in Templates in the app, with a live preview.

Group	For	Built-ins
Developers	Transactional email from your code	welcome, verify-email, password-reset, magic-link, team-invite, order-confirmation, receipt, shipping-update, booking-confirmation, feedback-request
Agents	Replies an AI agent fills in	support-reply, follow-up, schedule-meeting, escalation-handoff, order-status
Marketing	Newsletters and campaigns, with an unsubscribe link and address footer	newsletter, product-launch, promo-sale, event-invite, abandoned-cart, win-back

Write a template

Use {{name}} for a required value and {{name | fallback}} for an optional one. Dotted names such as {{order.total}} work. Values are HTML-escaped, so a variable cannot inject markup. Variables whose name ends in url, href or link must be http(s) or mailto links.

Send one

curl -X POST https://mail.flinkk.io/api/v1/emails \
  -H "Authorization: Bearer $FLINKK_API_KEY" -H "Content-Type: application/json" \
  -d '{"from":"Acme <hi@acme.com>","to":"sam@example.com","template":"verify-email","variables":{"product":"Acme","code":"482913"}}'

A missing required variable is a clear 400 missing_variables before anything is sent. An explicit subject overrides the template's.

API

Call
`GET /api/v1/templates`	List built-in and your own templates, with each one's variables.
`POST /api/v1/templates`	Create `{ name, subject, html?, text? }`.
`GET /api/v1/templates/{id}`	By id, your template's name, or a built-in id.
`PUT /api/v1/templates/{id}`	Update subject, html or text of your own template.
`DELETE /api/v1/templates/{id}`	Delete your own template.
`POST /api/v1/templates/render`	Preview `{ template, variables }` without sending.

For agents

The MCP server has list_templates and render_template, so an agent can fill a template and pass the result to a draft or send tool. Permissions and approvals still apply. See Agent inbox API.

On this page: Write a template · Send one · API · For agents