Skip to main content
POST
email.template.set

Authorizations

Authorization
string
header
required

A Lath API key: lath_live_sk… or lath_test_sk… on a server, lath_live_pk… or lath_test_pk… in a browser.

Headers

Idempotency-Key
string

Replays the stored response for the same key and input; refuses different input.

Body

application/json
name
string
required

The template name. Reserved names (auth.signin.code, auth.signin.link) override the built-in sign-in messages.

Required string length: 1 - 120
Pattern: ^[a-z][a-z0-9_-]*(\.[a-z][a-z0-9_-]*)*$
locale
string

Language variant, e.g. 'fr' or 'pt-BR'. Omit for the default variant used when nothing more specific fits the recipient.

Maximum string length: 20
subject
string

Required for a template that has never been published

Required string length: 1 - 998
html
string
Maximum string length: 200000
text
string

Plain-text part; derived from html when omitted

Maximum string length: 100000
layout
enum<string>

brand wraps the HTML in the project's themed frame (default); none sends the HTML as written

Available options:
brand,
none

Response

{ activityId, result }. activityId is empty for reads.

activityId
string
required

The activity this call created, or empty for a read.

result
object
required
Last modified on September 13, 2026