Create a new template

POST

emails

builder

curl --request POST \
  --url https://services.leadconnectorhq.com/emails/builder \
  --header 'Content-Type: application/json' \
  --header 'Version: <version>' \
  --data '
{
  "locationId": "ve9EPM428h8vShlRW1KT",
  "title": "template title",
  "updatedBy": "zYy3YOUuHxgomU1uYJty",
  "builderVersion": "2",
  "name": "Template1",
  "parentId": "zYy3YOUuHxgomU1uYJty",
  "templateDataUrl": "",
  "importURL": "https://tplshare.com/fhYJ3Mi",
  "templateSource": "template_library",
  "isPlainText": false,
  "subjectLine": "Email Subject",
  "fromName": "Name of sender",
  "fromEmail": "test@abc.com",
  "previewText": "preview text"
}
'

const options = {
  method: 'POST',
  headers: {Version: '<version>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    locationId: 've9EPM428h8vShlRW1KT',
    title: 'template title',
    updatedBy: 'zYy3YOUuHxgomU1uYJty',
    builderVersion: '2',
    name: 'Template1',
    parentId: 'zYy3YOUuHxgomU1uYJty',
    templateDataUrl: '',
    importURL: 'https://tplshare.com/fhYJ3Mi',
    templateSource: 'template_library',
    isPlainText: false,
    subjectLine: 'Email Subject',
    fromName: 'Name of sender',
    fromEmail: 'test@abc.com',
    previewText: 'preview text'
  })
};

fetch('https://services.leadconnectorhq.com/emails/builder', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://services.leadconnectorhq.com/emails/builder"

payload = {
    "locationId": "ve9EPM428h8vShlRW1KT",
    "title": "template title",
    "updatedBy": "zYy3YOUuHxgomU1uYJty",
    "builderVersion": "2",
    "name": "Template1",
    "parentId": "zYy3YOUuHxgomU1uYJty",
    "templateDataUrl": "",
    "importURL": "https://tplshare.com/fhYJ3Mi",
    "templateSource": "template_library",
    "isPlainText": False,
    "subjectLine": "Email Subject",
    "fromName": "Name of sender",
    "fromEmail": "test@abc.com",
    "previewText": "preview text"
}
headers = {
    "Version": "<version>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "redirect": "66e811229245fc098765590",
  "traceId": "0c52e980-41f6-4be7-8c4b-e2c5a13dc3c2"
}

{
  "statusCode": 400,
  "message": "Bad Request"
}

{
  "statusCode": 401,
  "message": "Invalid token: access token is invalid",
  "error": "Unauthorized"
}

{
  "statusCode": 422,
  "message": [
    "Unprocessable Entity"
  ],
  "error": "Unprocessable Entity"
}

Headers

Version

enum<string>

required

API Version

Available options:

2021-07-28

Example:

"2021-07-28"

Body

application/json

locationId

string

required

Example:

"ve9EPM428h8vShlRW1KT"

type

enum<string>

required

Available options:

html,

folder,

import,

builder,

blank,

ai_template

importProvider

enum<string>

required

Available options:

mailchimp,

active_campaign,

kajabi,

other

title

string

Example:

"template title"

updatedBy

string

Example:

"zYy3YOUuHxgomU1uYJty"

builderVersion

enum<string>

default:2

Available options:

1,

2

name

string

Example:

"Template1"

parentId

string

Example:

"zYy3YOUuHxgomU1uYJty"

templateDataUrl

string

Example:

""

importURL

string

Example:

"https://tplshare.com/fhYJ3Mi"

templateSource

string

Example:

"template_library"

isPlainText

boolean

Example:

false

subjectLine

string

Example:

"Email Subject"

fromName

string

Example:

"Name of sender"

fromEmail

string

Example:

"test@abc.com"

previewText

string

Example:

"preview text"

Response

Success

redirect

string

required

template id

Example:

"66e811229245fc098765590"

traceId

string

required

trace id

Example:

"0c52e980-41f6-4be7-8c4b-e2c5a13dc3c2"

Last modified on March 8, 2026

Emails Overview

Update a template

Create a new template

curl --request POST \
  --url https://services.leadconnectorhq.com/emails/builder \
  --header 'Content-Type: application/json' \
  --header 'Version: <version>' \
  --data '
{
  "locationId": "ve9EPM428h8vShlRW1KT",
  "title": "template title",
  "updatedBy": "zYy3YOUuHxgomU1uYJty",
  "builderVersion": "2",
  "name": "Template1",
  "parentId": "zYy3YOUuHxgomU1uYJty",
  "templateDataUrl": "",
  "importURL": "https://tplshare.com/fhYJ3Mi",
  "templateSource": "template_library",
  "isPlainText": false,
  "subjectLine": "Email Subject",
  "fromName": "Name of sender",
  "fromEmail": "test@abc.com",
  "previewText": "preview text"
}
'

const options = {
  method: 'POST',
  headers: {Version: '<version>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    locationId: 've9EPM428h8vShlRW1KT',
    title: 'template title',
    updatedBy: 'zYy3YOUuHxgomU1uYJty',
    builderVersion: '2',
    name: 'Template1',
    parentId: 'zYy3YOUuHxgomU1uYJty',
    templateDataUrl: '',
    importURL: 'https://tplshare.com/fhYJ3Mi',
    templateSource: 'template_library',
    isPlainText: false,
    subjectLine: 'Email Subject',
    fromName: 'Name of sender',
    fromEmail: 'test@abc.com',
    previewText: 'preview text'
  })
};

fetch('https://services.leadconnectorhq.com/emails/builder', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://services.leadconnectorhq.com/emails/builder"

payload = {
    "locationId": "ve9EPM428h8vShlRW1KT",
    "title": "template title",
    "updatedBy": "zYy3YOUuHxgomU1uYJty",
    "builderVersion": "2",
    "name": "Template1",
    "parentId": "zYy3YOUuHxgomU1uYJty",
    "templateDataUrl": "",
    "importURL": "https://tplshare.com/fhYJ3Mi",
    "templateSource": "template_library",
    "isPlainText": False,
    "subjectLine": "Email Subject",
    "fromName": "Name of sender",
    "fromEmail": "test@abc.com",
    "previewText": "preview text"
}
headers = {
    "Version": "<version>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "redirect": "66e811229245fc098765590",
  "traceId": "0c52e980-41f6-4be7-8c4b-e2c5a13dc3c2"
}

{
  "statusCode": 400,
  "message": "Bad Request"
}

{
  "statusCode": 401,
  "message": "Invalid token: access token is invalid",
  "error": "Unauthorized"
}

{
  "statusCode": 422,
  "message": [
    "Unprocessable Entity"
  ],
  "error": "Unprocessable Entity"
}

Emails

Email Verification

Campaigns

Social Planner

Trigger Links

Brand Boards

Headers

Body

Response