Skip to main content
POST
/
v1
/
objects
Create an object definition
curl --request POST \
  --url https://app.nex.ai/api/developers/v1/objects \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Project",
  "name_plural": "Projects",
  "slug": "project",
  "description": "Project tracker",
  "type": "custom"
}
'
{
  "attributes": [
    {
      "description": "<string>",
      "id": "<string>",
      "name": "<string>",
      "options": {
        "is_multi_value": true,
        "is_required": true,
        "is_unique": true,
        "is_whole_number": true,
        "select_options": [
          {
            "id": "<string>",
            "name": "<string>"
          }
        ],
        "use_raw_format": true
      },
      "slug": "<string>",
      "type": "<string>"
    }
  ],
  "created_at": "<string>",
  "description": "<string>",
  "id": "<string>",
  "name": "<string>",
  "name_plural": "<string>",
  "slug": "<string>",
  "type": "<string>"
}

Authorizations

Authorization
string
header
required

API key for authentication (format: "Bearer YOUR_API_KEY")

Body

application/json

Object definition to create

name
string
required

Display name for the object

slug
string
required

URL-safe identifier

name_plural
string

Plural display name

description
string

Description of the object type

type
enum<string>

Object type

Available options:
person,
company,
custom,
deal

Response

Created object definition

attributes
object[]
created_at
string
description
string
id
string
name
string
name_plural
string
slug
string
type
string
Last modified on February 17, 2026