Skip to main content
TemplatesVersion: v3New

Duplicate Email Template

POST/emails/locations/{locationId}/templates/{templateId}/duplicate

Clone this email template, optionally renaming it or placing it in an active template folder in this location. Returns the same public shape as Get Email Template.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:emails/templates.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Idempotency-Keystring

Unique key per intended write (max 255 chars). Retrying with the same key and body within 24 hours returns the first response instead of creating another resource. Reusing the key with a different body returns 422; a retry while the first request is still running returns 409.

Example:0f8fad5b-d9cb-469f-a165-70867728950e
Versionstringrequired

API Version

Available optionsv3
Example:v3

Path Parameters

locationIdstringrequired

Location ID

Example:ve9EPM428h8vShlRW1KT
templateIdstringrequired

Template ID

Example:507f1f77bcf86cd799439011

Body

namestring

Name for the new copy. Omit to keep the source name. Must not be empty when provided.

Example:Christmas 2026 (copy)
userIdstring

Optional user ID recorded as the creator of the copy. Does not affect authorization.

Example:ve9EPM428h8vShlRW1KT
parentFolderIdstring

ID of an active destination template folder in this location. Omit to place the copy at the root.

Example:67f15c2ae99226d5bcccb8f7

Response

Success

idstringrequired

Template ID

Example:507f1f77bcf86cd799439011
namestringrequired

Template name

Example:Newsletter Template
editorTypestringrequired

Editor type

Available optionshtmlbuildertext
Example:html
isPlainTextbooleanrequired

Whether template is plain text

Example:false
parentFolderIdstring

Parent folder ID

Example:67f15c2ae99226d5bcccb8f0
fromNamestring

Sender name

Example:John Doe
fromEmailstring

Sender email address

subjectstring

Email subject line

Example:Welcome to our newsletter
previewTextstring

Preview text

Example:Email preview text
editorContentUrlstring

URL to fetch the rendered template content as HTML. Issue a GET against this URL to retrieve the body.

Example:https://storage.googleapis.com/email-templates/abc123.html
editorContentobject

Current editor content, returned only when includeContent=true. A string (HTML or plain text) when editorType is html or text; the design-editor JSON (elements, attrs, templateSettings) when editorType is builder. Same shape the Update endpoint accepts, so it can be edited and sent back.

designEditorV2boolean

Returned as true with includeContent=true when the latest version was saved in the new design editor (DnD 2.0, block format). editorContent is then omitted: this API reads and writes only the classic design-editor JSON, and the stored classic version is older. A builder update through this API replaces the DnD 2.0 design.

Example:true
deletedbooleanrequired

Whether the template is deleted

Example:false
createdAtstring

Created timestamp

Example:2025-07-24T11:55:43.598Z
updatedAtstring

Updated timestamp

Example:2025-07-24T11:55:43.598Z
traceIdstring

Trace ID of request

Example:019e4ef5-a65e-4198-8cf9-8e93dca9bda4