Templates

Draft and published#

A template has a slug (1 to 63 lowercase letters, digits or dashes, unique per workspace), a name, a subject, an email document and a list of variables. It keeps a draft you edit and a published version that sends use. Publishing validates the draft: it needs a subject, every {{VARIABLE}} it uses must be declared, and a dry render must succeed. Sends always use the published version, so editing the draft never changes live mail. The detail answer includes draft, published and has_unpublished_changes.

# Start from a built in starter, then edit the draft and publish.
curl -X POST https://api.runearc.com/v1/templates \
  -H "Authorization: Bearer $RUNEARC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "from_starter": "password-reset" }'

curl -X POST https://api.runearc.com/v1/templates/$TEMPLATE_ID/publish \
  -H "Authorization: Bearer $RUNEARC_API_KEY"

Starter gallery#

Eighteen starters ship with real copy and declared variables. GET /v1/template-starters returns each with slug, name, description, category, subject, variables, document and a rendered preview. Create one with { "from_starter": "<slug>" }.

Send with a template#

Add template to POST /v1/emails: a slug, or { "id": "<slug>", "variables": {...} }. Do not also send html or text (template_conflict). The subject comes from the template unless you send one. The email is tagged template with the slug. A sending key may send with a template but cannot create or edit them. The rest of the send, including idempotency, limits and statuses, is on Emails API and Sending.

curl -X POST https://api.runearc.com/v1/emails \
  -H "Authorization: Bearer $RUNEARC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "from": "Acme <noreply@acme.com>", "to": ["ada@example.com"],
        "template": { "id": "password-reset",
                      "variables": { "RESET_URL": "https://acme.com/reset/abc" } } }'

API#

CLI and MCP#

runearc template starters
runearc template create --starter password-reset
runearc template publish tpl_...
runearc template send tpl_... --from "Acme <noreply@acme.com>" --to ada@example.com --var RESET_URL=https://acme.com/reset/abc

MCP tools: list_templates, create_template and send_template.

Errors#