Retrieve notes associated with contact

Develop, Build & Integrate APIs & Integrations
1

I need to retrieve all notes associated with a contact id. I am using Integromat + Custom API Call, easy to experiment with.

The hubspot engagement note documentation is hard for me to follow.

Where do I put the contact id?

https://api.hubapi.com/crm/v3/objects/notes?limit=10&properties=hs_note_body&associations=contact&archived=false&hapikey=YOUR_HUBSPOT_API_KEY.

2

Hi @jaysonb,

You have two options here:

Option 1:

Get the associated note ids on the contact

Post /crm/v3/associations/contact/note/batch/read

{"inputs": [{
"id": "457501"
}]}

Which will return:

{ "status": "COMPLETE", "results": [ { "from": { "id": "457501" }, "to": [ { "id": "22570614037", "type": "contact_to_note" }, { "id": "22570614134", "type": "contact_to_note" } ] } ], "startedAt": "2022-06-10T18:00:15.317Z", "completedAt": "2022-06-10T18:00:15.338Z" }

Then batch get the note properties

Post /crm/v3/objects/notes/batch/read

{"inputs": [
{"id": "22570614037"},
{"id": "22570614134"}
], "properties":["hs_note_body"]}

Which will return the details of the notes.

Option 2:

Post the search api

Post /crm/v3/objects/notes/search

{"filters":
[{"propertyName":"associations.contact","operator":"EQ","value":"457501"}],
"properties":["hs_note_body"]}

Which will return the details of the notes.

It may seem like option 2 is clearly better, but the search api has a seperate 4 per second api limit(seperate from all other requests). While the other two requests share the same 10 or 15(tier depending) api limit of all other requests.

Best,

3

Dude. Thank You!

I didnt see any of this in the documentation :slightly_smiling_face:

Got your first option at least working in seconds. You put me on the right track!!!