List Email Object
A list email is a single email sent to a recipient list.
Learn more about list emails in Salesforce Help.
The API to access the List Email object follows the conventions described in Version 5 Overview.
| Operation | HTTP Verb | URL Format | Ability Requirements |
|---|
| Create | POST | https://pi.pardot.com/api/v5/objects/list-emails?<params> | Marketing > Emails > Emails > Send To List ability |
| Read | GET | https://pi.pardot.com/api/v5/objects/list-emails/<id>?<params> | Marketing > Emails > Emails > View ability |
| Query | GET | https://pi.pardot.com/api/v5/objects/list-emails?<params> | Marketing > Emails > Emails > View ability |
| Statistics | GET | https://pi.pardot.com/api/v5/objects/list-emails/<id>/stats | Marketing > Emails > Emails > View Report ability |
| Field | Type | Description |
|---|
name | String | The name of the object for identification in Account Engagement. |
campaignId | Integer | The ID of the campaign related to this object. |
recipientListIds | Array | An array of IDs of the recipient lists. The email is sent to all users on the specified lists. Write-Only field on create operation. |
| Field | Type | Description |
|---|
subject | String | The list email subject. |
textMessage | String | The text content of the email’s message. This field isn’t queryable. |
htmlMessage | String | The HTML content of the email’s message. This field isn’t queryable. |
senderOptions | Sender Options[] | An array of the sender options. |
replyToOptions | Reply To Options[] | An array of the reply to address options. |
scheduledTime | DateTime | The ISO 8601 date and time to send the email. Write-Only field on create operation. |
isOperational | Boolean | When true, the email is sent to the prospect regardless of opt-out status. Your account must have Operational Email Sending enabled to use this setting. |
emailTemplateId | Integer | The ID of the email template used for the list email. |
trackerDomainId | Integer | The ID of the tracker domain used for the list email. |
suppressionListIds | Array | An array of IDs of the suppression lists. The email isn’t sent to any user on the suppression lists. Write-Only field on create operation. |
folderId | Integer | The ID of the folder containing this object. |
| Field | Type | Description |
|---|
id | Integer | The ID of the list email. |
isPaused | Boolean | True if the email send is paused. |
isSent | Boolean | True if the email has been sent. |
isDeleted | Boolean | True if the object is in the recycle bin in Account Engagement. |
clientType | String | The type of client that was used to send the email. The value is Builder if the email was sent using the Lightning Email Builder, or Web if it was sent using the legacy Pardot email builder. |
createdById | Integer | The ID of the user who created this object. |
updatedById | Integer | The ID of the user who last updated this object. |
createdAt | DateTime | Creation time of the list email. |
updatedAt | DateTime | Last update time of the list email. |
sentAt | DateTime | The date and time when the list email was sent. |
operationalEmail | Boolean | Deprecated. Use isOperational instead. True if the email is operational. |
recipientLists | Recipient Lists[] | An array of the lists used for this list email. |
suppressionLists | Suppression Lists[] | An array of the lists used as suppression lists for the list email. |
createdBy | User | User object representing the user who created this object. See documentation for User for fields. |
updatedBy | User | User object representing the user who last updated this object. See documentation for User for fields. |
campaign | Campaign | Campaign object representing the campaign that was set on Create. See documentation for Campaign for fields. |
folder | Folder | JSON object representing the folder for this object. See documentation for Folder for fields. |
trackerDomain | Tracker Domain | Tracker Domain object representing the tracker domain associated with this object. See documentation for Tracker Domain for fields. |
type | Enum | The content type of the email. Possible values are html (Read and Query only), text, and htmlAndText. |
| Field Name | Data Type | Description |
|---|
senderOptions.type | Enum<string> | The sending user type. Can be general_user, specific_user, assigned_user or account_owner. When performing read or query, account_custom_field and prospect_custom_field are also available. |
senderOptions.address | String | The sending email address. |
senderOptions.name | String | The name of the sender. |
senderOptions.userId | Integer | The user ID of the sender. |
senderOptions.prospectCustomFieldId | Integer | The ID of the prospect custom field that contains the sender value. |
senderOptions.accountCustomFieldId | Integer | The ID of the account custom field that contains the sender value. |
| Field Name | Data Type | Description |
|---|
replyToOptions.type | Enum<string> | The reply to user type. Can be general_address, specific_user, assigned_user or account_owner. When performing read or query, account_custom_field and prospect_custom_field are also available. |
replyToOptions.address | String | The reply-to email address. |
replyToOptions.userId | Integer | The user ID of the reply to sender. |
replyToOptions.prospectCustomFieldId | Integer | The ID of the prospect custom field that contains the reply to value. This field isn’t editable. |
replyToOptions.accountCustomFieldId | Integer | The ID of the account custom field that contains the reply to value. This field isn’t editable. |
Send an email to every prospect on the specified list following the conventions described in the Version 5 Overview.
Example Request
");else if(O._boomrl=function(){t()},O.addEventListener)O.addEventListener("load",O._boomrl,!1);else if(O.attachEvent)O.attachEvent("onload",O._boomrl);d.close()}function a(e){window.BOOMR_onload=e&&e.timeStamp||(new Date).getTime()}if(!window.BOOMR||!window.BOOMR.version&&!window.BOOMR.snippetExecuted){window.BOOMR=window.BOOMR||{},window.BOOMR.snippetStart=(new Date).getTime(),window.BOOMR.snippetExecuted=!0,window.BOOMR.snippetVersion=12,window.BOOMR.url=n+"96ZND-LJLSH-JXHC9-F8GQP-6WCGS";var o=document.currentScript||document.getElementsByTagName("script")[0],i=!1,r=document.createElement("link");if(r.relList&&"function"==typeof r.relList.supports&&r.relList.supports("preload")&&"as"in r)window.BOOMR.snippetMethod="p",r.href=window.BOOMR.url,r.rel="preload",r.as="script",r.addEventListener("load",e),r.addEventListener("error",function(){t(!0)}),setTimeout(function(){if(!i)t(!0)},3e3),BOOMR_lstart=(new Date).getTime(),o.parentNode.appendChild(r);else t(!1);if(window.addEventListener)window.addEventListener("load",a,!1);else if(window.attachEvent)window.attachEvent("onload",a)}}(),"".length>0)if(e&&"performance"in e&&e.performance&&"function"==typeof e.performance.setResourceTimingBufferSize)e.performance.setResourceTimingBufferSize();!function(){if(BOOMR=e.BOOMR||{},BOOMR.plugins=BOOMR.plugins||{},!BOOMR.plugins.AK){var n=""=="true"?1:0,t="",a="eyab6kadmwalajqacqemiaaacfvc3hge-f-57f2d098b-clienttons-s.akamaihd.net",o="false"=="true"?2:1,i={"ak.v":"41","ak.cp":"1836958","ak.ai":parseInt("1224868",10),"ak.ol":"0","ak.cr":1,"ak.ipv":6,"ak.proto":"h2","ak.rid":"8051ac94","ak.r":41279,"ak.a2":n,"ak.m":"dsca","ak.n":"essl","ak.cport":44112,"ak.gh":"23.218.223.73","ak.quicv":"","ak.tlsv":"tls1.3","ak.0rtt":"","ak.0rtt.ed":"","ak.csrc":"-","ak.acc":"","ak.t":"1781374148","ak.ak":"hOBiQwZUYzCg5VSAfCLimQ==pnSsXZoNu/W0C1XUCjpR7TSYEnYaINe7FYG4DhPYCXXX+YeET/KL+dtKBEV4+FZYxStrS2jabAFYbeqH1NJBHlQKXTjv6uQGgFrn/eGoMm40D/h80d5GK/L3wB1uLwBPb0Lu6sz5knF9/VBPIRC2mFCsxo9hdVF8p6LbEM/hgwZV9NsP1x+Pu8A5yqNmUpypppqZofKM6JYaVw30CWXKkVnwtQHWY3cSuUaoWPiPgSPhu9eghR9WipeEWarO36uxfgfyKvLQ7jsoy5YqrH34d7GzDd2sJE8Qg8r0SVA1wpYKpALgykOXqzbLetSJMmyB6vJhDCnNeXrkfadm25nSvlHDUYsrBTqdaCBQLSjPfXUeiOY1C51F2uhF9tkdVJBHzLXAqtd+gxR2ivu+bsNNQ/Sao99qQEGDcKXTK2I7brc=","ak.pv":"87","ak.dpoabenc":"","ak.tf":o};if(""!==t)i["ak.ruds"]=t;var r={i:!1,av:function(n){var t="http.initiator";if(n&&(!n[t]||"spa_hard"===n[t]))i["ak.feo"]=void 0!==e.aFeoApplied?1:0,BOOMR.addVar(i)},rv:function(){var e=["ak.cport","ak.cr","ak.csrc","ak.gh","ak.ipv","ak.m","ak.n","ak.ol","ak.proto","ak.quicv","ak.tlsv","ak.0rtt","ak.0rtt.ed","ak.r","ak.acc","ak.t","ak.tf"];BOOMR.removeVar(e)}};BOOMR.plugins.AK={akVars:i,akDNSPreFetchDomain:a,init:function(){if(!r.i){var e=BOOMR.subscribe;e("before_beacon",r.av,null,null),e("onbeacon",r.rv,null,null),r.i=!0}return this},is_complete:function(){return!0}}}}()}(window);hello, goodbye. %%unsubscribe%%