Hi Community,
I have been trying to add a note to custom object(later app object) using [api]( Create - HubSpot docs ).
{
"status": "error",
“message”: “The scope needed for this API call isn’t available for public use. If you have questions, contact support or post in our developer forum.”,
“correlationId”: “019fa273-1113-79f9-867a-676c7bf5d2fc”,
“links”: {
“support”: “https://help.hubspot.com/”,
“forum”: “https://community.hubspot.com/t5/APIs-Integrations/bd-p/integrations”
},
“category”: “MISSING_SCOPES”
}
Body:
{
“associations”: [
{
“to”: {
“id”: “314126412490”
},
“types”: [
{
“associationTypeId”: 22,
“associationCategory”: “USER_DEFINED”
}
\]
}
],
“properties”: {
“hs_timestamp”: “2026-07-01T00:00:00Z”,
“hs_note_body”: “My audit message here”
}
}
Thanks in Advance for the help.
PS: I have write scope for custom & contact object ( “crm.objects.contacts.write”, “crm.objects.custom.write”)
Hi @ramkumar1021!
The error "The scope needed for this API call isn't available for public use" is a different issue from a simple missing scope; it means the legacy notes endpoint you’re using requires a scope that isn’t publicly available.
Here’s what’s happening and how to fix it:
- You’re using the legacy API (
/legacy/crm/activities/notes). Switch to the current Notes API instead.
- Required scope: The current create-note endpoint requires
crm.objects.contacts.write — which you already have. The legacy endpoint may require an internal/private scope.
- Your association: You’re associating to a custom/app object. Make sure you also have
crm.objects.custom.write (which you do) and that the associationTypeId: 22 is valid for your object pair.
Switch to the current endpoint at /api-reference/latest/crm/activities/notes/create-note — your existing scopes should be sufficient.
Let me know how that goes 
Cassie, Community Manager