Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages

createEmailTemplate method

Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages

It is a method to create an email template for a mass campaign. To edit an existing template, you can use the updateEmailTemplate method.

Principle of use

Syntax and URL to call the method
createEmailTemplate (string title, string subject, string body, string lang,
string message_format, string text_body, string raw_body, string description)
api_key * API access key.
title * Template name.
subject * String with the letter subject. It may include substitution fields.
body * Text of the letter template in the HTML format with the possibility to add substitution fields.If you transfer the entire HTML text, test such letters additionally as headers outside the body may be modified. In addition, in order to reduce a difference in the display in various mail applications, we automatically add additional markup to each letter (a table with invisible borders, which also sets a default font and left alignment of the text). You may request to turn it off for your letters by contacting our technical support service.
description A text description of the template, which can be obtained later on when calling this template.
text_body Text version of the letter template.
lang Two-letter language code for the string with the unsubscribe link that is added to each letter automatically.

If it is not specified, the language code from the API URL is used.

In addition to the string with the unsubscribe link, this language also affects the interface of the unsubscribe page. Languages ru, it, ua and en are fully supported, and in case of some other languages (da, de, es, fr, nl, pl, pt, tr), the string with a link will be translated, and the control interface will be in English.

message_format It defines the way of creating a template: «block» — block editor, «raw_html»— html editor, text — text.

  • If you transfer the «text», value in this parameter, then if both the body and text_body parameters are filled in, the body parameter will be ignored and the template will be created based on the data transferred in the text_body parameter.
  • If you transfer the «block»value in this parameter but do not specify raw_body, the template will be saved as raw_html.
  • If you transfer the «block» value in this parameter, the body and body и raw_body parameters must be transferred for the message to be saved in the block editor format.
raw_body It is intended to save the json structure of the block editor data structure (if the value is message_format = block) The parameter obtains only the JSON structure, otherwise it will not be transferred.
Return value
JSON object with the following fields:template_id — identifier of the created template;

warnings — array containing warning fields (if any).

Example of the return value in case the template has been created successfully:

    "template_id": 1234567890
    {"warning":"some warning text, if applicable"}

При ошибке:

{"error":"error message", "code":"error code"}
Оцените, на сколько вам показалась полезной статья «createEmailTemplate method»

Did we answer to your question?