Skip to main content
POST
/
v1
/
objects
/
{slug}
/
lists
Create a list
curl --request POST \
  --url https://app.nex.ai/api/developers/v1/objects/{slug}/lists \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "VIP Contacts",
  "slug": "vip-contacts",
  "description": "High-value contacts"
}
'
{
  "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")

Path Parameters

slug
string
required

Object slug (e.g., 'person', 'company')

Body

application/json

List to create

name
string
required

List display name

slug
string
required

URL-safe identifier

name_plural
string

Plural name

description
string

List description

Response

Created list

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