Adding Notes to HubSpot Contact Records: Workarounds Needed

Ross R. · 2025-08-11T06:43:52.137Z

Hi Trying to add notes to a contact record in Hubspot. I have pro plan. I have email text from smartlead webhook. I can only see contact fields on the update object. Any work arounds?

Adding Notes to HubSpot Contact Records: Workarounds Needed | Clay

8 comments

· Sorted by Oldest

Clay
APP
·
·
The HubSpot "Update object" action only updates contact fields, not notes. To add notes to HubSpot contacts, use the "Create object" action instead and select "Notes" as the object type. For notes via API, use the endpoint: [https://api.hubapi.com/crm/v3/objects/notes](https://api.hubapi.com/crm/v3/objects/notes) with properties like hs_note_body, hs_timestamp, and hubspot_owner_id. Include association type 202 to link the note to the contact. Your Smartlead webhook email text can be mapped to the hs_note_body field when creating the note object.
Sources: Update object with HubSpot | Clay.com HubSpot integration | Documentation | Clay University
Ross R.
·
·
there is no object type notes, only Deal, lead, contact, company
Muhammad S.
·
·
you have to add note via http api to the contacts Ross R.
Hari K.
·
·
Hey there - Wanted to check in if the community was able to solve this? Happy to help if you are still running into issues
Ross R.
·
·
i don't understand, whats the point of premium if you need to use an http API. I' like a heads up from support
Hari K.
·
·
Hey Ross - With the native Hubspot integration, we only have the capability to update the fields that populate in the "Update Object" enrichment configuration when you select the respective object type. Hope this helps!
Ross R.
·
·
yes keen to understand how to post notes in hubsot
Daniel K.
·
·
Hey Ross, thanks for reaching out. You're right—the native Create/Update Object step in Clay doesn’t currently support creating Notes directly in HubSpot. But there’s a solid workaround using Clay’s HTTP API step, which gives you full access to the HubSpot Notes API. Here’s how you can set it up: 1. Add an HTTP API action in Clay ** Use the URL: [https://api.hubapi.com/crm/v3/objects/notes](https://api.hubapi.com/crm/v3/objects/notes) ** Method: POST ** Auth: Bearer token with your HubSpot private app token 2. Set up your payload like this::**LBKS```LBKS{ "properties":: { "hs_note_body": "Your note content here" }, "associations": [ { "to": { "id": "RECORD_ID" }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": ASSOCIATION_TYPE_ID } ] } ] }```Key Fields:** ** hs_note_body: Your actual note ** RECORD_ID: ID of the contact, company, or deal you’re attaching the note to ** ASSOCIATION_TYPE_ID: HubSpot's internal ID for linking notes to the right object You'll need to make sure your API token has the right scopes (e.g. crm.objects.contacts.write). Let me know if you still have questions here. I want to make sure you have what you need.

Clay
APP
·
·
The HubSpot "Update object" action only updates contact fields, not notes. To add notes to HubSpot contacts, use the "Create object" action instead and select "Notes" as the object type. For notes via API, use the endpoint: [https://api.hubapi.com/crm/v3/objects/notes](https://api.hubapi.com/crm/v3/objects/notes) with properties like hs_note_body, hs_timestamp, and hubspot_owner_id. Include association type 202 to link the note to the contact. Your Smartlead webhook email text can be mapped to the hs_note_body field when creating the note object.
Sources: Update object with HubSpot | Clay.com HubSpot integration | Documentation | Clay University
Ross R.
·
·
there is no object type notes, only Deal, lead, contact, company
Muhammad S.
·
·
you have to add note via http api to the contacts Ross R.
Hari K.
·
·
Hey there - Wanted to check in if the community was able to solve this? Happy to help if you are still running into issues
Ross R.
·
·
i don't understand, whats the point of premium if you need to use an http API. I' like a heads up from support
Hari K.
·
·
Hey Ross - With the native Hubspot integration, we only have the capability to update the fields that populate in the "Update Object" enrichment configuration when you select the respective object type. Hope this helps!
Ross R.
·
·
yes keen to understand how to post notes in hubsot
Daniel K.
·
·
Hey Ross, thanks for reaching out. You're right—the native Create/Update Object step in Clay doesn’t currently support creating Notes directly in HubSpot. But there’s a solid workaround using Clay’s HTTP API step, which gives you full access to the HubSpot Notes API. Here’s how you can set it up: 1. Add an HTTP API action in Clay ** Use the URL: [https://api.hubapi.com/crm/v3/objects/notes](https://api.hubapi.com/crm/v3/objects/notes) ** Method: POST ** Auth: Bearer token with your HubSpot private app token 2. Set up your payload like this::**LBKS```LBKS{ "properties":: { "hs_note_body": "Your note content here" }, "associations": [ { "to": { "id": "RECORD_ID" }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": ASSOCIATION_TYPE_ID } ] } ] }```Key Fields:** ** hs_note_body: Your actual note ** RECORD_ID: ID of the contact, company, or deal you’re attaching the note to ** ASSOCIATION_TYPE_ID: HubSpot's internal ID for linking notes to the right object You'll need to make sure your API token has the right scopes (e.g. crm.objects.contacts.write). Let me know if you still have questions here. I want to make sure you have what you need.