Email Template Resources

Use an email template to design a reusable email layout for your engagement programs, autoresponders, one-to-one emails, and list emails. Learn about email templates in Salesforce Help.

Note: Include the authentication header with every request. For information on how to authenticate, see Authentication.

Resource Name Operation Description
Email Template Read GET Request information about a single email template.
One-to-One Email Templates GET Request information about the email templates that are used in one-to-one emails.

Email Template Read

Request information about a single email template.

URI

/api/emailTemplate/version/3/do/read/id/<ID>

Replace <ID> with the Pardot ID of the email template.

Parameters to Select a Template

Use this parameter to specify the email templates to return.

Parameter Type Possible Values Description
archived boolean true, false If true, the request returns archived and unarchived templates. If false, only unarchived templates are returned. Default value is false.

One-to-One Email Templates

Request the email templates that are enabled for one-to-one emails.

URI

/api/emailTemplate/version/3/do/listOneToOne

Parameters to Select One-to-One Email Templates

Use this parameter to specify which one-to-one email templates to return.

Parameter Type Possible Values Description
archived boolean true, false If true, the request returns both archived and unarchived templates. If false, only unarchived templates are returned. Default is false.

XML Response

Use the XML response for read requests and one-to-one requests to learn more about your email templates.

XML Response for an Email Template Read

<rsp stat="ok" version="1.0">
    <emailTemplate>
        <error></error>
        <errorCode></errorCode>
        <errorMessage></errorMessage>
    </emailTemplate>
    --- or ---
    <emailTemplate>
        <error></error>
        <sendOptions>
            <replyToAddress></replyToAddress>
            <sendFromData></sendFromData>
        </sendOptions>
        <id></id>
        <name></name>
        <htmlMessage></htmlMessage>
        <textMessage></textMessage>
        <isDripEmail></isDripEmail>
        <isListEmail></isListEmail>
        <subject></subject>
    </emailTemplate>
</rsp>
Tag Description
<emailTemplate> Parent tag. Contains data fields for a single email template.
<error> Flag if an error occurred.
<errorCode> Code for the error which occurred.
<errorMessage> Description of the error.
<sendOptions> The associated send options object, including sender-specific data.
<replyToAddress> The email address in the email's Reply-To header.
<sendFromData> A JSON array representing the sender hierarchy tied to the email template.
<id> The Pardot ID of the email template.
<name> The name of the email template.
<htmlMessage> The HTML version of the email template body.
<textMessage> The plain text version of the email template body.
<isDripEmail> Flag if the template is available for use in engagement programs.
<isListEmail> Flag if the template is available for use in list emails.
<subject> The subject of the email message.

XML Response for One-to-One Email Templates

<rsp stat="ok" version="1.0">
    <emailTemplates>
        <templates>
            <id></id>
            <name></name>
            <isOneToOneEmail>1</isOneToOneEmail>
            <isArchived></isArchived>
            <isAutoResponderEmail></isAutoResponderEmail>
            <isDripEmail></isDripEmail>
            <isListEmail></isListEmail>
            <subject></subject>
        </templates>
        <templates>...</templates>
        <templates>...</templates>
    </emailTemplates>
</rsp>
Tag Description
<emailTemplates> Parent tag. Contains individual email template records.
<templates> Parent tag for each template.
<id> The Pardot ID of the email template.
<name> The name of the email template.
<isOneToOneEmail> Flag if the email template is available for use in one-to-one emails (always true).
<isArchived> Flag if the email template is in the Recycle Bin in Pardot.
<isAutoResponderEmail> Flag if the email template is available for use as an auto response from a form submission.
<isDripEmail> Flag if the email template is available for use in engagement programs.
<isListEmail> Flag if the email template is available for use in list emails.
<subject> The subject of the email message.