Skip to main content
POST
Create email template

Authorizations

Authorization
string
header
required

API key created in the organization settings.

Headers

Idempotency-Key
string

Unique key for the operation. Repeating the same key with the same body returns the original response instead of running it again.

Body

application/json
name
string
required
Required string length: 1 - 191
subject
string
required
Required string length: 1 - 191
document
object
required

Bevits email editor document (version, settings, blocks).

operation_id
string

Optional unique id for this call, such as a UUID. Reuse the same value only to retry the same call: the retry returns the first result instead of creating again. The same value with a different body is rejected with 409.

Required string length: 8 - 128

Response

Email template created.

object
string
required
Allowed value: "email_template"
id
string
required
Pattern: ^etp_[A-Za-z0-9_-]+$
compile_errors
string[]
required

Blocks that could not be built; the template is saved without a body until they are fixed.