For the complete documentation index, see llms.txt. This page is also available as Markdown.

Create a contact property

Adds a custom property (column) to your contacts. If the name is already used, a number is added to make it unique.

For select and dropdown, list the options in settings.labels; if you leave them out, three placeholder labels are created. Accounts that haven't moved to the new contact table can only create text, number, select, date and checkbox properties.

post
Authorizations
api_keystringRequired

Your business's Cekat API key, from Settings → Developers & API in the Cekat dashboard (https://chat.cekat.ai/developers?section=apikeys). Available on the Business and Enterprise plans.

Body
namestringRequiredExample: Customer tier
typestring · enumRequiredPossible values:
is_requiredbooleanOptionalDefault: false
is_visiblebooleanOptionalDefault: true
is_uniquebooleanOptionalDefault: false
read_onlybooleanOptionalDefault: false
Responses
201

Property created.

application/json
messagestringOptional
post/api/crm/contact/property
POST /api/crm/contact/property HTTP/1.1
Host: api.cekat.ai
api_key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 152

{
  "name": "Customer tier",
  "type": "select",
  "settings": {
    "labels": [
      {
        "id": "0",
        "name": "Gold",
        "color": "#FFCB00"
      },
      {
        "id": "1",
        "name": "Silver",
        "color": "#C4C4C4"
      }
    ]
  }
}
{
  "message": "success",
  "data": {
    "id": "7a6b5c4d-3e2f-4a1b-8c9d-0e1f2a3b4c5d",
    "board_id": "3b2a1c0d-9e8f-4a7b-6c5d-4e3f2a1b0c9d",
    "name": "Customer tier",
    "type": "select",
    "settings": {
      "labels": [
        {
          "id": "0",
          "name": "Gold",
          "color": "#FFCB00"
        },
        {
          "id": "1",
          "name": "Silver",
          "color": "#C4C4C4"
        }
      ]
    },
    "is_required": false,
    "is_visible": true,
    "is_unique": false,
    "read_only": false,
    "position": 12,
    "created_at": "2026-10-12T10:10:00.000000+00:00"
  }
}

Last updated