# Create a new property

Creates a new property for a specific object using the provided property details. The SavePropertyDTO must include necessary details, and the object association is determined by the objectUuid path variable. Returns a CreateResponse containing the newly created property as a PropertyDTO. Validation rules: name (required, must be unique, must be lowercase, must match name pattern (lowercase letters, numbers, underscores)), label (required), description (maximum 255 characters), type (required, must be one of valid PropertyTypes, cannot be changed after creation), format (required, must be one of valid PropertyFormats, cannot be changed after creation), rules (required, must be an array of string).

Endpoint: POST /api/v2/objects/{objectUuid}/properties/
Version: 1.0
Security: BearerAuthentication

## Path parameters:

  - `objectUuid` (string, required)

## Request fields (application/json):

  - `uuid` (string, required)
    Unique identifier for the entity

  - `name` (string)
    The internal name of the property
    Example: "property_name"

  - `label` (string)
    The display label of the property
    Example: "Property Label"

  - `createdAt` (integer)
    Unix timestamp when the entity was created

  - `createdBy` (object)
    Identifier of the user who created the entity

  - `createdBy.name` (string, required)

  - `createdBy.label` (string)

  - `createdBy.createdAt` (integer)

  - `createdBy.updatedAt` (integer)

  - `createdBy.deletedAt` (integer)

  - `createdBy.createdByUuid` (string)

  - `createdBy.updatedByUuid` (string)

  - `createdBy.deletedByUuid` (string)

  - `createdBy.index` (integer)

  - `createdBy.complete` (boolean)

  - `createdBy.deleted` (boolean)

  - `createdBy.uuid` (string, required)

  - `createdBy.objects` (object)

  - `createdBy.properties` (array)

  - `createdBy.properties.value` (any)

  - `createdBy.properties.type` (string)

  - `createdBy.properties.icon` (string)

  - `createdBy.user` (object)

  - `createdBy.user.email` (string)

  - `createdBy.user.firstname` (string)

  - `createdBy.user.lastname` (string)

  - `createdBy.user.initials` (string)

  - `createdBy.user.scopes` (array)

  - `createdBy.user.filters` (object)

  - `createdBy.user.role` (string)

  - `createdBy.user.record` (object)

  - `updatedAt` (integer)
    Unix timestamp when the entity was last updated

  - `updatedBy` (object)
    Identifier of the user who last updated the entity

  - `deletedAt` (integer)
    Unix timestamp when the entity was deleted (null if not deleted)

  - `deletedBy` (object)
    Identifier of the user who deleted the entity

  - `index` (integer)
    Index number for ordering entities

  - `description` (string)
    A brief description of the property
    Example: "This is a sample property description"

  - `type` (string)
    The data type of the property
    Example: "string"

  - `options` (array)
    List of available options for the property

  - `options.color` (string)

  - `options.disabled` (boolean)

  - `options.usedIn` (object)

  - `options.usedIn.recordUuids` (array)

  - `options.usedIn.count` (integer)

  - `group` (string)
    The group to which this property belongs
    Example: "General"

  - `format` (string)
    Property format type
    Example: "single-line"

  - `rules` (array)
    Collection of rules applied to the property

  - `hidden` (boolean)
    Indicates if the property is hidden by default

  - `nonPublic` (boolean)
    Indicates if the property is not accessible publicly

  - `indexed` (boolean)
    Indicates if the property is indexed

  - `formatSettings` (object)
    Settings to configure the format of the property

  - `immutable` (boolean)
    Indicates if the property is immutable

  - `editable` (boolean)
    Indicates if the property can be edited
    Example: true

  - `icon` (string)
    The icon associated with the property
    Example: "icon_name"

  - `webpagePublic` (boolean)
    Indicates if the property is webpage public

  - `embeddable` (boolean)
    Indicates if the property is embeddable

## Response 201 fields (application/json):

  - `message` (string)
    A message detailing the result of the operation.
    Example: "Success"

  - `data` (any)
    The data payload of the response, if any.

## Response 400 fields (*/*):

  - `message` (string)
    The error message providing details about the failure.
    Example: "Resource not found."

  - `errors` (object)
    A list of error types providing further details about the error.
    Example: [{"field":"name","message":"Name is required.","correctionSuggestion":"Please provide a name."}]

  - `errors.correctionSuggestion` (string, required)
    A suggestion on how to correct the error.
    Example: "Try uploading a different file type."

  - `errors.type` (string, required)
    The type of error.
    Enum: "VALIDATION", "NOT_FOUND", "TEST", "RELATION_NOT_ALLOWED", "INVALID_VALUE", "GENERAL", "INVALID_FILE_TYPE", "INTERNAL_SERVER_ERROR", "CARAER_ERROR", "INVALID_EMAIL", "INVALID_DATE"

  - `status` (integer)
    The HTTP status code associated with the error.
    Example: 400

  - `stackTrace` (string)

  - `roles` (array)
    Enum: "USER", "ADMIN", "RESELLER", "DEVELOPER", "SUPER_ADMIN"

  - `scopes` (array)

## Response 500 fields (*/*):

  - `message` (string)
    The error message providing details about the failure.
    Example: "Resource not found."

  - `errors` (object)
    A list of error types providing further details about the error.
    Example: [{"field":"name","message":"Name is required.","correctionSuggestion":"Please provide a name."}]

  - `errors.correctionSuggestion` (string, required)
    A suggestion on how to correct the error.
    Example: "Try uploading a different file type."

  - `errors.type` (string, required)
    The type of error.
    Enum: "VALIDATION", "NOT_FOUND", "TEST", "RELATION_NOT_ALLOWED", "INVALID_VALUE", "GENERAL", "INVALID_FILE_TYPE", "INTERNAL_SERVER_ERROR", "CARAER_ERROR", "INVALID_EMAIL", "INVALID_DATE"

  - `status` (integer)
    The HTTP status code associated with the error.
    Example: 400

  - `stackTrace` (string)

  - `roles` (array)
    Enum: "USER", "ADMIN", "RESELLER", "DEVELOPER", "SUPER_ADMIN"

  - `scopes` (array)