# Create a new custom record type

Create a new custom record type

            Creates a new custom record type with the specified field schema.
            The record type name must be unique and follow naming conventions.

Business Applications:
- Define custom data structures
- Extend system capabilities

Real Example:
bash
curl --location 'https://{{host}}/api/v1/records/custom' \
--header 'Authorization: bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
  "name": "Example Name",
  "displayName": "Example Name",
  "description": "example value"
}'

Endpoint: POST /api/v1/records/custom
Version: 1.0.0
Security: BearerAuth

## Request fields (application/json):

  - `name` (string, required)
    Name

  - `displayName` (string,null)
    Displayname

  - `description` (string,null)
    Description

  - `fields` (array, required)
    Fields

  - `fields.type` (string)
    Type

  - `fields.required` (boolean)
    Required

  - `fields.nullable` (boolean)
    Nullable

  - `fields.referencedEntityType` (string,null)
    Referencedentitytype

  - `fields.rank` (integer,null)
    Rank

## Response 201 fields (application/json):

  - `data` (object)

  - `data.id` (integer)
    Id

  - `data.name` (string)
    Name

  - `data.displayName` (string)
    Displayname

  - `data.description` (string,null)
    Description

  - `data.isCustom` (boolean)
    Iscustom

  - `data.active` (boolean)
    Active

  - `data.fields` (array)
    Fields

  - `data.recordsUrl` (string,null)
    Recordsurl

  - `data.schemaUrl` (string)
    Schemaurl

  - `error` (object,null)

  - `meta` (object)

  - `meta.success` (boolean)

  - `meta.message` (string)

  - `meta.timestamp` (string)

  - `meta.version` (string)


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 500 fields