> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an object

> Define a kind of record for your workspace.

Requires `object_types:write`, a verified administrator, and Objects enabled for the workspace.
Creation adds an empty definition. It does not automatically add a Name
attribute or create records. Add attributes from the Object's Attributes tab
in Manage.

### Parameters

<ParamField body="key" type="string" required>
  Immutable key beginning with `objects.`, followed by a lowercase letter and
  lowercase letters, numbers, or underscores. Maximum 73 characters including
  the prefix. Must be unique within the workspace. The slug `test` and slugs
  beginning with `test_` are reserved.
</ParamField>

<ParamField body="singular_name" type="string" required>
  Name for one record. Maximum 100 characters.
</ParamField>

<ParamField body="plural_name" type="string" required>
  Name for the collection. Maximum 100 characters.
</ParamField>

<ParamField body="icon" type="string">
  Defaults to `regular/cube`. Supported icons are:

  `regular/cube`, `regular/users`, `regular/user`, `regular/building`, `regular/briefcase`, `regular/id-card`, `regular/handshake`, `regular/globe`,
  `regular/laptop`, `regular/mobile-screen`, `regular/server`, `regular/database`, `regular/code`, `regular/gear`, `regular/wrench`, `regular/camera`,
  `regular/folder`, `regular/file-lines`, `regular/file-contract`, `regular/clipboard-check`, `regular/graduation-cap`, `regular/book`, `regular/certificate`, `regular/lightbulb`,
  `regular/calendar`, `regular/clock`, `regular/location-dot`, `regular/plane`, `regular/truck`, `regular/box-archive`, `regular/tag`, `regular/cart-shopping`,
  `regular/wallet`, `regular/credit-card`, `regular/coins`, `regular/receipt`, `regular/chart-line`, `regular/shield-check`, `regular/heart`, `regular/leaf`.
</ParamField>

<ParamField body="description" type="string">
  Optional description. Maximum 1,000 characters.
</ParamField>

### Returns

Returns the created [Object definition](/reference/object-types/object).

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "objt_example",
    "object": "object_type",
    "key": "objects.equipment",
    "singular_name": "Equipment item",
    "plural_name": "Equipment",
    "description": "Company equipment",
    "icon": "regular/laptop",
    "workspace": "wsp_example"
  }
  ```
</ResponseExample>