API reference · Email

Create a template

Save an email you send often. Use {{first_name}} style fields and fill them with template_vars.

POST/v1/email/templates

Bearer API key
Rate limit 120 / min
Returns 200 OK
Needs the Email permission · free

POST /v1/email/templates

curl https://api.talks.africa/v1/email/templates \
  -H "Authorization: Bearer $TALKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "order_receipt",
    "subject": "Your receipt",
    "html": "<h1>Thanks, {{first_name}}</h1>"
  }'

{
  "id": "tpl_order_receipt",
  "name": "order_receipt",
  "created_at": "2026-11-13T18:02:11Z"
}

Use a tk_test_ key while you build. Nothing is sent and no credits are used.

Body parameters

namestringrequired
Template name.
subjectstringoptional
Default subject.
htmlstringoptional
HTML body.
textstringoptional
Plain-text body.

Response fieldsResponse

id
Template ID
name
As set
created_at
Timestamp

Errors

Tap one to see its response above.

All errors use the standard error object. Select one to see its response.

Was this page helpful?