---
title: "Create new Custom Object Type"
method: POST
path: "/custom_object_type/"
tags: ["custom_object_types"]
---

# Create new Custom Object Type

`POST /custom_object_type/`

The type must be created before Custom Fields can be added.

The following fields are required:
  - `name`: The name of the Custom Object Type
  - `name_plural`: A pluralized version of the name, for some UI display.

The following fields are optional:
  - `description`: A longer description of the Custom Object Type.
  - `api_create_only`: If `true`, instances can only be created by API clients. Defaults to `false`.
  - `editable_with_roles`: Only users with the given roles can edit instances of this type. By default, any user in your organization can make changes to the instances of this type.

## Response `201`

Successful response

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)