The note pinning feature @3PETE described only applies to the HubSpot UI.
It is still not possible to pin notes or other engagements via API. Unfortunately, I am not aware of any plans to add this to the Engagements or CRM APIs in the foreseeable future.
That said, I found this similar request on the Ideas Forum, where the product team is more likely to see feedback on desired new features. I've upvoted the idea and recommend you do the same, adding a description of your use case as a comment.
How to pin an engagement note using the engagement API
SOLVE
I agree, but we did this with a bit of user education, and our "pinned" note, is dedicated links to external resources, which is unlikely to be updated by a user.... Like I showed in the ticket, our note has a heading and a link underneath, and in the back end i coded it so that i check if note is there with my title (not something a user will ever use), if not i will create it, and if the note is there, push an entire new body+timestamp to overwrite any changes that could possibly have been made to the note...
It's not perfect, but right now it beats the **bleep** out of having a note lost in the weeds...
Specifically as to a user creating a new note... You could probably hammer hubspot and push the update once a minute? For us, its 6 hours, a bit of user education (and by this I mean a decent note heading that everyone understands), and some automagic coding in the backend... its 100% hands off, 0 intervention, and I would assume that you wanting it to update via API you have this information coming from an external source, which would most likely not be accessible to the user, which is why you are doing it anyway...
Anyway, just thought I would share the hack I've found, sorry that it couldn't be useful for you.
How to pin an engagement note using the engagement API
SOLVE
Thanks for the suggestion. Using the timestamp is a little fragile in the interaction between users and machines. If a user creates a new note, that becomes the note with the most recent timestamp (and would implicitly be considered the pinned note using the logic you suggested).
The note pinning feature @3PETE described only applies to the HubSpot UI.
It is still not possible to pin notes or other engagements via API. Unfortunately, I am not aware of any plans to add this to the Engagements or CRM APIs in the foreseeable future.
That said, I found this similar request on the Ideas Forum, where the product team is more likely to see feedback on desired new features. I've upvoted the idea and recommend you do the same, adding a description of your use case as a comment.
How to pin an engagement note using the engagement API
SOLVE
@amardeep_rai Right now there isn’t a way to do this. The pinning a note feature was just released/in open beta. This is something we will look to add to the API functionality down the road.