Skip to main content
POST
Create an email template
A reusable subject and HTML body. Email steps reference templates by id and pick between them by weight.

Authorizations

x-api-key
string
header
required

Team-scoped API key generated in the Salesfinity dashboard under Settings -> Connections & API. A missing or invalid key returns HTTP 403.

Body

application/json
name
string
required
subject
string
required

Supports merge fields, e.g. {{first_name}}.

body_html
string
required

HTML body. Merge fields resolve against the contact; {{custom.<label>}} resolves a custom field by its label, case-insensitively.

user_id
string
required

The team member authoring the template.

tags
string[]
archived
boolean

Archived templates stay usable by steps already pointing at them.

Response

Success.

A reusable email body.

_id
string

24-character hexadecimal id.

Example:

"507f1f77bcf86cd799439011"

name
string
subject
string
body_html
string
tags
string[]
archived
boolean
send_count
integer
open_count
integer
reply_count
integer
bounce_count
integer