template-list - GMS for Developers

Returns the list of all or some templates of the account.

You can iterate thru large list using “offset” and “limit” parameters. When less than “limit” templates are returned then the end of list is reached.

https://dns-name/template/list

Request Body

POST https://dns-name/template/list
Content-Type: application/json
X-API-KEY: Value

{
  "limit": 0,
  "offset": 0
}

Request Parameters

Name	Type	Description
limit	INTEGER	Limits the number of templates returned, default is 50
offset	INTEGER	Index of the first template in the list, starting with 0

Response Body

{
  "status": "string",
  "templates": [
    {
      "id": "string",
      "name": "string",
      "body": {
        "html": "string",
        "plaintext": "string",
        "amp": "string"
      },
      "subject": "string",
      "headers": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      },
      "attachments": [
        {
          "type": "string",
          "name": "string",
          "content": "string"
        }
      ],
      "template_builder": "string",
      "template_creator": "string",
      "global_replacements": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      },
      "global_info": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      },
      "sender_email": "string",
      "sender_name": "string",
      "reply_to": "string",
      "check_links": 0,
      "check_read": 0,
      "inline_attachments": [
        {
          "type": "string",
          "name": "string",
          "content": "string"
        }
      ]
    }
  ]
}

Response Parameters

Name	Type	Description
status	STRING REQUIRED	«Success» string
templates	ARRAY REQUIRED	Array of template objects
»id	STRING (UUID) REQUIRED	Template unique identifier
»name	STRING (UUID) REQUIRED	Template name
»template_builder	STRING	Editor type, “html” or “visual”. Default is “html”. You can create a template with “visual” editor type only in web interface.
»global_replacements	OBJECT	Object for passing the substitutions(merge tags) common for all recipients – e.g., company name. If the substitution names are duplicated in object “substitutions”, the values of the variables will be taken from the object “substitutions”. The substitutions can be used in the following parameters: – body.html – body.plaintext – body.amp – subject – sender_name – headers[“List-Unsubscribe”] – options.unsubscribe_url A substitution name can consist from latin characters, numbers and “_” or “-” symbols, and should start with the letter.
»global_info	OBJECT	Object for passing the info common for all the recipients, such as “key”: “value”. Max key quantity: 10. Max key length: 64 symbols. Max value length: 1024 symbols. The metadata is returned by webhook on your endpoint.
»body	OBJECT REQUIRED	Contains HTML/plaintext/AMP parts of the email. Either html or plaintext part is required.
»»html	STRING	HTML part of the email body
»»plaintext	STRING	Plaintext part of the email body
»»amp	STRING	Optional AMP part of the email body
»subject	STRING	Email subject
»sender_email	STRING	Sender’s email. Required only if template_id parameter is empty.
»sender_name	STRING	Sender’s name
»reply_to	STRING	Optional Reply-To email (in case it’s different to sender’s email)
»check_links	INTEGER	1=click tracking is on (default), 0=click tracking is off
»check_read	INTEGER	1=read tracking is on (default), 0=read tracking is off
»headers	OBJECT	Contains email headers, maximum 50. Only headers with “X-” name prefix are accepted, all other are ignored, for example X-GMS-Global-Language, X-GMS-Template-Engine.
»attachments	ARRAY	Optional array of attachments
»»type	STRING REQUIRED	Attachment type, see MIME. If unsure, use “application/octet-stream”.
»»name	STRING REQUIRED	Attachment name in the format: “name.extension” Attachment content id. For example, “name”=“IMAGECID1” should be referenced in HTML like <img src=“cid:IMAGECID1”>
»»content	STRING (BYTE) REQUIRED	File contents in base64. Maximum file size 7MB (9786710 bytes in base64).
»inline_attachments	ARRAY	Optional array of inline attachments, e.g. for including images in email instead of loading them from external URL
»created	STRING (UTC-DATA-TIME) REQUIRED	Template creation date and time in UTC timezone in format “YYYY-MM-DD hh:mm:ss”
»user_id	INTEGER REQUIRED	Unique user identifier

HTTP Code default:

Error occurred

{
  "status": "string",
  "code": 0,
  "message": "string"
}

Name	Type	Description
status	STRING REQUIRED	«Error» string
message	STRING REQUIRED	Human-readable error message in English
code	INTEGER REQUIRED	API Error code