Creating Email Engagements


When I create an email engagement for a contact I’m not seeing the body of the mail displayed in the UI. Also are there additional metadata fields to include things like the following?

  • Subject
  • To Addresses
  • From Address
  • CC
  • BCC
  • Attachments


Hi James

Email engagements have a slightly different JSON structure than the other engagement types. It should look similar to this:

“engagement”: {
“active”: true,
“type”: “EMAIL”
“associations”: {
“contactIds”: [
“companyIds”: [
“dealIds”: [],
“ownerIds”: []
“metadata”: {
“from”: {
“email”: “",
“firstName”: “Daniel",
“lastName”: “Bertschi"
“to”: [
“email”: “Daniel Bertschi"
“cc”: [],
“bcc”: [],
“subject”: “Email subject”,
“html”: "

Email Body
“text”: “Email Body”

Best, Daniel


Thanks Daniel, this should really be added to the docs.


Totally agreed. I’ll ask for this to be added to the docs.


James, just a quick note to let you know that the docs were updated:

Best, Daniel


Hi Daniel,

In which parameter should I provide my email body to log it in well formatted manner in Hubspot? Do I need to pass it in “html” or in “text” or both?

Thanks in advance!


This worked somewhat for me. But I'm not seeing the From and To fields in the UI, even though I can see I am sending them as you suggested.