Create custom attribute definition

post

https://api.zenskar.com/custom_attributes

Create a new custom attribute definition for an organisation, or a specific business entity within it.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

attribute_key_name

string

required

length ≥ 1

A unique system identifier for the attribute (e.g., customer_tier, internal_notes).

display_name

string

required

length ≥ 1

A user-friendly label for the attribute shown in the UI.

module

string

enum

required

The module this custom attribute belongs to (e.g., customer, products, contracts).

Allowed:

data_type

string

enum

required

The type of data the attribute will store.

business_entity_id

If populated, this definition is an entity-specific addition or override.

is_tag

boolean

If TRUE, this attribute is a Tag. Tags must have data_type = ENUM.

enum_choices

If data_type is ENUM, this stores the list of valid string choices.

default_value

An optional default value for the attribute. Must conform to data_type and be one of enum_choices if applicable.

is_required

boolean

Indicates if a value is mandatory for this attribute.

is_enabled

boolean

Whether the attribute definition is currently active.

sort_order

Optional: for controlling display order in UIs.

description

Optional: further description or help text for the attribute.

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Successful Response

422Validation Error