Render and Send Template

post

https://a.klaviyo.com/api/v1/email-template/{template_id}/send

Renders the specified template with the provided data and send the contents in an email via the service specified. This API is intended to test templates only, and is rate limited to the following thresholds: 100/hour, 1,000/day.

🚧
Deprecation Notice
This endpoint is being deprecated and we are no longer verifying accounts for this functionality. To achieve similar functionality, create a metric-triggered flow, then send one or more Track API calls.

Path Params

template_id

string

required

Defaults to TEMPLATE_ID

Form Data

from_email

string

required

Defaults to [email protected]

from_name

string

required

Defaults to George Washington

subject

string

required

Defaults to Happy Fourth!

blob

required

Defaults to [{"name":"Abraham Lincoln","email":"[email protected]"}]

Mixed. string, or JSON encoded array of objects with "email" and "name" keys.
[email protected]
OR
[{"name":"Abraham Lincoln","email":"[email protected]"}]

context

blob

Defaults to { "name" : "George Washington", "state" : "VA" }

Optional, JSON object.
This is the context your email template will be rendered with. Email templates are rendered with contexts in a similar manner to how Django templates are rendered. This means that nested template variables can be referenced via dot notation and template variables without corresponding context values are treated as falsy and output nothing.
ex: { "name" : "George Washington", "state" : "VA" }

Response

🚧Deprecation Notice

200The Email Template object with an additional data property that contains the status of the message. If successful, the status will be queued.

🚧
Deprecation Notice