Get Template by Name or ID

curl --request GET \
  --url https://cloudapi.mailercloud.com/v1/templates/details \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://cloudapi.mailercloud.com/v1/templates/details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://cloudapi.mailercloud.com/v1/templates/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://cloudapi.mailercloud.com/v1/templates/details"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": {
    "plainText": "Hello Reader",
    "id": "k",
    "name": "temp 1",
    "html": "<html>....</html>",
    "categoryId": 10,
    "createdDate": "2023-06-28 14:04:16",
    "modifiedDate": "2023-07-03 11:24:15",
    "status": "active"
  }
}

{
  "error": "Template Name does not exist"
}

{
  "errors": [
    {
      "field": "",
      "message": "Authorization failed"
    }
  ]
}

Get Template by Name or ID

This endpoint retrieves the full details of an email template in mailercloud. You can fetch a template either by passing the template name or its ID in the query parameters.

curl --request GET \
  --url  https://cloudapi.mailercloud.com/v1/templates/details?name=example \
  --header 'Authorization: Your API Key here'

curl --request GET \
  --url  https://cloudapi.mailercloud.com/v1/templates/details?id=abc \
  --header 'Authorization: Your API Key here'

GET

templates

details

Get Template by Name or ID

curl --request GET \
  --url https://cloudapi.mailercloud.com/v1/templates/details \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://cloudapi.mailercloud.com/v1/templates/details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://cloudapi.mailercloud.com/v1/templates/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://cloudapi.mailercloud.com/v1/templates/details"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": {
    "plainText": "Hello Reader",
    "id": "k",
    "name": "temp 1",
    "html": "<html>....</html>",
    "categoryId": 10,
    "createdDate": "2023-06-28 14:04:16",
    "modifiedDate": "2023-07-03 11:24:15",
    "status": "active"
  }
}

{
  "error": "Template Name does not exist"
}

{
  "errors": [
    {
      "field": "",
      "message": "Authorization failed"
    }
  ]
}

Authorizations

Authorization

string

header

required

Your Mailercloud API key (plain text, no Bearer prefix). Create keys in Settings → API.

Query Parameters

name

string

Template name to look up. Provide either name or id.

string

Template ID to look up. Provide either name or id.

Response

data

object

Show child attributes

Get Template Categories Get Automation Details

⌘I

Campaigns

Custom Properties

Contacts

Lists

Segments

Senders

Account

Webforms

Tags

Webhooks

Templates

Automations

Inbox Tracker

Get Template by Name or ID

Authorizations

Query Parameters

Response