# Unable to create Custom Object via API

**URL:** <https://community.hubspot.com/t/unable-to-create-custom-object-via-api/147779>\
**Category:** CRM\
**Tags:** developer\
**Created:** [March 28, 2026, 6:37am UTC](https://community.hubspot.com/t/unable-to-create-custom-object-via-api/147779 "2026-03-28T06:37:01Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![Nkarnam](https://avatars.discourse-cdn.com/v4/letter/n/ad7895/32.png) [@Nkarnam](https://community.hubspot.com/u/Nkarnam)\
**Post date:** [March 28, 2026, 6:37am UTC](https://community.hubspot.com/t/unable-to-create-custom-object-via-api/147779/1 "2026-03-28T06:37:01Z")

</div>

We have been trying to create a Custom Object via API and have run into a scope issue.  
HubSpot AI docs lists out **crm.schemas.custom.write** as a required scope to create a custom object as shown in the image below. BUT, this is scope does not exist and is not recognised by HubSpot at all, hence creating a Custom Object via API is not possible.

 ![Nkarnam_0-1774679558735.png](https://d2qpr2jzcazej7.cloudfront.net/original/3X/1/1/11711574d26321b58e387f3b08cb2ea9b55a6e38.png)

 ![Nkarnam_1-1774679650434.png](https://d2qpr2jzcazej7.cloudfront.net/original/3X/8/7/875e87dc0e344dcf691b990312085edf643be68b.png)

 ![Nkarnam_3-1774679749669.png](https://d2qpr2jzcazej7.cloudfront.net/original/3X/0/e/0e9d91da92806e0d8c453a1e1dbdc8ccb12a393b.png)

---

<div class="post-metadata">

**Author:** ![Yeti\_Chris](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/yeti_chris/32/13521_2.png) [@Yeti\_Chris](https://community.hubspot.com/u/Yeti_Chris)\
**Post date:** [March 28, 2026, 2:46pm UTC](https://community.hubspot.com/t/unable-to-create-custom-object-via-api/147779/2 "2026-03-28T14:46:52Z")

</div>

Will you regularly create custom objects and need an automated way to do so, or is this a one-time event?

Have you tried creating the custom object manually and then mapping the field to populate the data. Know this does not scale but may resolve the issue.

---

<div class="post-metadata">

**Author:** ![Greatness\_1](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/greatness_1/32/228412_2.png) [@Greatness\_1](https://community.hubspot.com/u/Greatness_1)\
**Post date:** [March 29, 2026, 9:39pm UTC](https://community.hubspot.com/t/unable-to-create-custom-object-via-api/147779/3 "2026-03-29T21:39:30Z")

</div>

Yeah, this is a known confusion with HubSpot’s docs.

The scope **crm.schemas.custom.write** is referenced in some AI-generated or outdated docs, but it’s not an actual valid scope you can assign in a private app.

### What’s actually going on

To create custom objects via API, you don’t need a separate “custom schema” scope you need the correct **CRM schema permissions** , which are typically covered under:

- crm.objects.custom.write _(for records)_
- and more importantly, access to \*_schema endpoints is restricted to certain app types_

In many cases, **custom object schema creation isn’t fully supported via standard private app scopes** , especially depending on your portal permissions and app setup.

* * *

### What to check

1. Make sure you’re using a **Private App** (not API key / legacy app)
2. Ensure your app has:
  - full CRM access scopes

3. Confirm your **HubSpot plan** supports custom objects (Enterprise only)

* * *

### Important limitation

Even with correct scopes, **schema creation endpoints can be restricted** , and HubSpot sometimes expects custom objects to be created via:

- UI first, then managed via API  
or
- specific internal/approved apps

* * *

### Bottom line

You’re not missing anything that scope doesn’t exist.  
The issue is **documentation inconsistency + restricted schema access** , not your implementation.