Skip to main content
POST
Create property

Authorizations

Authorization
string
header
required

Enter your API key. Example: Bearer poelis_api_...

Body

application/json

Request to create a new property.

item_id
string
required

Item ID to create the property on

type
string
required

Property type: numeric, matrix, text, date, or status. Formula not supported via public API.

name
string
required

Property name

Minimum string length: 1
readable_id
string
required

Human-readable property ID (must be unique within item). Only lowercase letters, numbers and underscores are allowed.

Minimum string length: 1
Pattern: ^[a-z0-9_]+$
value
any
required

Property value (string/number depending on type)

category
string | null

Category (required for numeric and matrix)

display_unit
string | null

Display unit (required for numeric and matrix)

Response

Created property

Unified public property representation.

id
string
required
readable_id
string
required

Human-readable property ID

item_id
string
required
name
string
required
type
enum<string>
required
Available options:
numeric,
text,
date,
status,
matrix,
formula
value
any
required

Property value. Numeric: plain number or matrix (category/display_unit always set; matrix value string e.g. "[[1,2,3],[4,5,6]]") or formula (category/display_unit never set; value is the result of the computation including unit if any). Text: string. Date: string, ISO date (e.g. "2025-01-29"). Status: string, one of "Draft", "Under Review", "Done".

deleted
boolean
required
category
string | null

Category. For numeric (plain number or matrix) always set; for formula never set.

display_unit
string | null

Display unit. For numeric (plain number or matrix) always set; for formula never set.

draft_property_id
string | null
references
PublicPropertyReference · object[]

References to source documents for this property

formula_expression
string | null

Formula expression for numeric properties that calculate their value from other properties. Uses @{property_id} syntax to reference dependencies. The value field holds the result of this computation, including unit if any.

createdBy
PublicUser · object | null

User who created the property

Example:
createdAt
string | null

ISO 8601 creation timestamp

updatedAt
string | null

ISO 8601 last-update timestamp

updatedBy
PublicUser · object | null

User who last updated the property

Example: