# How to create a Note on Custom Object / App objects

**URL:** <https://community.hubspot.com/t/how-to-create-a-note-on-custom-object-app-objects/154219>\
**Category:** APIs & Integrations\
**Tags:** developer\
**Created:** [July 27, 2026, 7:24am UTC](https://community.hubspot.com/t/how-to-create-a-note-on-custom-object-app-objects/154219 "2026-07-27T07:24:54Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![ramkumar1021](https://avatars.discourse-cdn.com/v4/letter/r/7ea924/32.png) [@ramkumar1021](https://community.hubspot.com/u/ramkumar1021)\
**Post date:** [July 27, 2026, 7:24am UTC](https://community.hubspot.com/t/how-to-create-a-note-on-custom-object-app-objects/154219/1 "2026-07-27T07:24:55Z")

</div>

Hi Community,

I have been trying to add a note to custom object(later app object) using [api]( [Create - HubSpot docs](https://developers.hubspot.com/docs/api-reference/legacy/crm/activities/notes/create-note) ).

> {
> 
> ```auto
> "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/](https://help.hubspot.com/)”,
> 
> “forum”: “[https://community.hubspot.com/t5/APIs-Integrations/bd-p/integrations](https://community.hubspot.com/t5/APIs-Integrations/bd-p/integrations)”
> 
> ```auto
> },
> 
> ```
> 
> “category”: “MISSING\_SCOPES”
> 
> }

> Body:
> 
> {
> 
> “associations”: [
> 
> ```auto
> {
> 
> ```
> 
> “to”: {
> 
> “id”: “314126412490”
> 
> ```auto
> },
> 
> ```
> 
> “types”: [
> 
> ```auto
> {
> 
> ```
> 
> “associationTypeId”: 22,
> 
> “associationCategory”: “USER\_DEFINED”
> 
> ```auto
> }
> 
> \]
> 
> }
> 
> ```
> 
> ],
> 
> “properties”: {
> 
> “hs\_timestamp”: “2026-07-01T00:00:00Z”,
> 
> “hs\_note\_body”: “My audit message here”
> 
> }
> 
> }

Thanks in Advance for the help.

---

<div class="post-metadata">

**Author:** ![ramkumar1021](https://avatars.discourse-cdn.com/v4/letter/r/7ea924/32.png) [@ramkumar1021](https://community.hubspot.com/u/ramkumar1021)\
**Post date:** [July 27, 2026, 7:26am UTC](https://community.hubspot.com/t/how-to-create-a-note-on-custom-object-app-objects/154219/2 "2026-07-27T07:26:26Z")

</div>

PS: I have write scope for custom & contact object ( “crm.objects.contacts.write”, “crm.objects.custom.write”)

---

<div class="post-metadata">

**Author:** ![chighsmith](https://avatars.discourse-cdn.com/v4/letter/c/77aa72/32.png) [@chighsmith](https://community.hubspot.com/u/chighsmith)\
**Post date:** [July 27, 2026, 1:36pm UTC](https://community.hubspot.com/t/how-to-create-a-note-on-custom-object-app-objects/154219/4 "2026-07-27T13:36:35Z")

</div>

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:

1. **You’re using the legacy API** (`/legacy/crm/activities/notes`). Switch to the **current Notes API** instead.
2. **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.
3. **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](https://community.hubspot.com/api-reference/latest/crm/activities/notes/create-note) — your existing scopes should be sufficient.

Let me know how that goes 🙂

Cassie, Community Manager

---

<div class="post-metadata">

**Author:** ![ramkumar1021](https://avatars.discourse-cdn.com/v4/letter/r/7ea924/32.png) [@ramkumar1021](https://community.hubspot.com/u/ramkumar1021)\
**Post date:** [July 31, 2026, 10:43am UTC](https://community.hubspot.com/t/how-to-create-a-note-on-custom-object-app-objects/154219/5 "2026-07-31T10:43:04Z")

</div>

Thanks a lot : )