POST FormTypes

Back to endpoints

POST FormTypes

Creates a new form type.

Request Information

URI Parameters

None.

Body Parameters

The form type to create. FormTypeId should not be filled in.

FormType

Name	Type	Additional information
FormTypeId	globally unique identifier	None.
Name	string	None.
Description	string	None.
AssetType	AssetType	None.
FrequencyNeeded	integer	None.
ValueNeededDate	date	None.
Fields	Collection of FormTypeField	None.
SourceSystemId	string	None.
CompanyId	globally unique identifier	None.
CreateDate	date	None.
CreateUser	string	None.
LastModifiedDate	date	None.
LastModifiedUser	string	None.

Request Formats

application/json, text/json

Sample:

{
  "FormTypeId": "d612b92c-22fb-4594-9736-1e009fc9567b",
  "Name": "sample string 1",
  "Description": "sample string 2",
  "AssetType": {
    "AssetTypeId": "95225386-defe-4945-b39d-412031f78014",
    "Name": "sample string 1",
    "Description": "sample string 2",
    "IsWell": true,
    "DisplayColor": "sample string 4",
    "SourceSystemId": "sample string 5",
    "CompanyId": "a88c3d2a-72aa-443b-9d6e-be5d379b4c00",
    "CreateDate": "2026-08-11T22:23:15.553612-07:00",
    "CreateUser": "sample string 7",
    "LastModifiedDate": "2026-08-11T22:23:15.553612-07:00",
    "LastModifiedUser": "sample string 8"
  },
  "FrequencyNeeded": 1,
  "ValueNeededDate": "2026-08-11T22:23:15.553612-07:00",
  "Fields": [
    {
      "FormTypeFieldId": "ba2fa4fa-cbbd-4d88-b011-f61be3507b71",
      "Section": {
        "FormTypeSectionId": "9c4e3628-f255-4ba7-9248-5ce3e03c5b8c",
        "Name": "sample string 1",
        "Label": "sample string 2",
        "DisplayOrder": 1,
        "IsRepeatable": true,
        "VisibleExpression": "sample string 4",
        "SourceSystemId": "sample string 5"
      },
      "Name": "sample string 1",
      "Label": "sample string 2",
      "Description": "sample string 3",
      "DataType": {
        "DataTypeId": "dff233f1-15d9-400b-9251-32154f94ff74",
        "Name": "sample string 1"
      },
      "Unit": {
        "UnitId": "ddebd1f1-b93e-4222-96dd-5152e84728d5",
        "Code": "sample string 1",
        "Description": "sample string 2",
        "SourceSystemId": "sample string 3",
        "CompanyId": "19ff76b2-1135-4143-ac14-c8dadc7983b1",
        "CreateDate": "2026-08-11T22:23:15.553612-07:00",
        "CreateUser": "sample string 5",
        "LastModifiedDate": "2026-08-11T22:23:15.553612-07:00",
        "LastModifiedUser": "sample string 6"
      },
      "DisplayOrder": 1,
      "MinValue": 1.0,
      "MaxValue": 1.0,
      "MinLength": 1,
      "MaxLength": 1,
      "HasValidValues": true,
      "ValidValues": [
        {
          "ValidValueId": "5031e3f4-157f-4d0a-a982-fc9712f9f927",
          "FieldId": "46bea3f0-5f9a-498f-8958-cf1260b49e3a",
          "FieldName": "sample string 1",
          "FieldLable": "sample string 2",
          "ValueText": "sample string 3",
          "LabelText": "sample string 4"
        },
        {
          "ValidValueId": "5031e3f4-157f-4d0a-a982-fc9712f9f927",
          "FieldId": "46bea3f0-5f9a-498f-8958-cf1260b49e3a",
          "FieldName": "sample string 1",
          "FieldLable": "sample string 2",
          "ValueText": "sample string 3",
          "LabelText": "sample string 4"
        }
      ],
      "ValueExpression": "sample string 5",
      "RequiredExpression": "sample string 6",
      "IsAttachment": true,
      "DefaultValueExpression": "sample string 8",
      "IsAccumulator": true,
      "IsMultiline": true,
      "IsRepeatable": true,
      "VisibleExpression": "sample string 12",
      "SourceSystemId": "sample string 13"
    },
    {
      "FormTypeFieldId": "ba2fa4fa-cbbd-4d88-b011-f61be3507b71",
      "Section": {
        "FormTypeSectionId": "9c4e3628-f255-4ba7-9248-5ce3e03c5b8c",
        "Name": "sample string 1",
        "Label": "sample string 2",
        "DisplayOrder": 1,
        "IsRepeatable": true,
        "VisibleExpression": "sample string 4",
        "SourceSystemId": "sample string 5"
      },
      "Name": "sample string 1",
      "Label": "sample string 2",
      "Description": "sample string 3",
      "DataType": {
        "DataTypeId": "dff233f1-15d9-400b-9251-32154f94ff74",
        "Name": "sample string 1"
      },
      "Unit": {
        "UnitId": "ddebd1f1-b93e-4222-96dd-5152e84728d5",
        "Code": "sample string 1",
        "Description": "sample string 2",
        "SourceSystemId": "sample string 3",
        "CompanyId": "19ff76b2-1135-4143-ac14-c8dadc7983b1",
        "CreateDate": "2026-08-11T22:23:15.553612-07:00",
        "CreateUser": "sample string 5",
        "LastModifiedDate": "2026-08-11T22:23:15.553612-07:00",
        "LastModifiedUser": "sample string 6"
      },
      "DisplayOrder": 1,
      "MinValue": 1.0,
      "MaxValue": 1.0,
      "MinLength": 1,
      "MaxLength": 1,
      "HasValidValues": true,
      "ValidValues": [
        {
          "ValidValueId": "5031e3f4-157f-4d0a-a982-fc9712f9f927",
          "FieldId": "46bea3f0-5f9a-498f-8958-cf1260b49e3a",
          "FieldName": "sample string 1",
          "FieldLable": "sample string 2",
          "ValueText": "sample string 3",
          "LabelText": "sample string 4"
        },
        {
          "ValidValueId": "5031e3f4-157f-4d0a-a982-fc9712f9f927",
          "FieldId": "46bea3f0-5f9a-498f-8958-cf1260b49e3a",
          "FieldName": "sample string 1",
          "FieldLable": "sample string 2",
          "ValueText": "sample string 3",
          "LabelText": "sample string 4"
        }
      ],
      "ValueExpression": "sample string 5",
      "RequiredExpression": "sample string 6",
      "IsAttachment": true,
      "DefaultValueExpression": "sample string 8",
      "IsAccumulator": true,
      "IsMultiline": true,
      "IsRepeatable": true,
      "VisibleExpression": "sample string 12",
      "SourceSystemId": "sample string 13"
    }
  ],
  "SourceSystemId": "sample string 3",
  "CompanyId": "9c225352-9352-4389-b9b4-e2e236092cb7",
  "CreateDate": "2026-08-11T22:23:15.553612-07:00",
  "CreateUser": "sample string 5",
  "LastModifiedDate": "2026-08-11T22:23:15.553612-07:00",
  "LastModifiedUser": "sample string 6"
}

Response Information

Resource Description

On success, the created form type.

Name	Type	Additional information
Data	FormType	None.
Total	integer	None.
Message	string	None.

Response Formats

application/json, text/json

Sample:

{
  "Data": {
    "FormTypeId": "2f2dc152-912b-4910-b67d-fa0c66dcf0c9",
    "Name": "sample string 1",
    "Description": "sample string 2",
    "AssetType": {
      "AssetTypeId": "bec165f0-3e3b-413a-978b-e3fb46f1d323",
      "Name": "sample string 1",
      "Description": "sample string 2",
      "IsWell": true,
      "DisplayColor": "sample string 4",
      "SourceSystemId": "sample string 5",
      "CompanyId": "0cac9a9a-b14d-4743-af6d-cf033ee14fda",
      "CreateDate": "2026-08-11T22:23:15.553612-07:00",
      "CreateUser": "sample string 7",
      "LastModifiedDate": "2026-08-11T22:23:15.553612-07:00",
      "LastModifiedUser": "sample string 8"
    },
    "FrequencyNeeded": 1,
    "ValueNeededDate": "2026-08-11T22:23:15.553612-07:00",
    "Fields": [
      {
        "FormTypeFieldId": "a189892c-9496-400d-af7c-7e165d527b90",
        "Section": {
          "FormTypeSectionId": "cce349e4-09d8-40c0-a2f4-3e131af52fc9",
          "Name": "sample string 1",
          "Label": "sample string 2",
          "DisplayOrder": 1,
          "IsRepeatable": true,
          "VisibleExpression": "sample string 4",
          "SourceSystemId": "sample string 5"
        },
        "Name": "sample string 1",
        "Label": "sample string 2",
        "Description": "sample string 3",
        "DataType": {
          "DataTypeId": "c837d7ec-321d-4e2b-9eec-7b119a2274cb",
          "Name": "sample string 1"
        },
        "Unit": {
          "UnitId": "7a032db2-8f1e-4988-96f8-bc60b684e864",
          "Code": "sample string 1",
          "Description": "sample string 2",
          "SourceSystemId": "sample string 3",
          "CompanyId": "e07579bd-a8a7-4ca4-a08e-d64f3fd30491",
          "CreateDate": "2026-08-11T22:23:15.553612-07:00",
          "CreateUser": "sample string 5",
          "LastModifiedDate": "2026-08-11T22:23:15.553612-07:00",
          "LastModifiedUser": "sample string 6"
        },
        "DisplayOrder": 1,
        "MinValue": 1.0,
        "MaxValue": 1.0,
        "MinLength": 1,
        "MaxLength": 1,
        "HasValidValues": true,
        "ValidValues": [
          {
            "ValidValueId": "7fd6f1f0-7762-4089-b369-7661d725da49",
            "FieldId": "fba0d35d-c708-4cf0-bb76-092d8ba40e4f",
            "FieldName": "sample string 1",
            "FieldLable": "sample string 2",
            "ValueText": "sample string 3",
            "LabelText": "sample string 4"
          },
          {
            "ValidValueId": "7fd6f1f0-7762-4089-b369-7661d725da49",
            "FieldId": "fba0d35d-c708-4cf0-bb76-092d8ba40e4f",
            "FieldName": "sample string 1",
            "FieldLable": "sample string 2",
            "ValueText": "sample string 3",
            "LabelText": "sample string 4"
          }
        ],
        "ValueExpression": "sample string 5",
        "RequiredExpression": "sample string 6",
        "IsAttachment": true,
        "DefaultValueExpression": "sample string 8",
        "IsAccumulator": true,
        "IsMultiline": true,
        "IsRepeatable": true,
        "VisibleExpression": "sample string 12",
        "SourceSystemId": "sample string 13"
      },
      {
        "FormTypeFieldId": "a189892c-9496-400d-af7c-7e165d527b90",
        "Section": {
          "FormTypeSectionId": "cce349e4-09d8-40c0-a2f4-3e131af52fc9",
          "Name": "sample string 1",
          "Label": "sample string 2",
          "DisplayOrder": 1,
          "IsRepeatable": true,
          "VisibleExpression": "sample string 4",
          "SourceSystemId": "sample string 5"
        },
        "Name": "sample string 1",
        "Label": "sample string 2",
        "Description": "sample string 3",
        "DataType": {
          "DataTypeId": "c837d7ec-321d-4e2b-9eec-7b119a2274cb",
          "Name": "sample string 1"
        },
        "Unit": {
          "UnitId": "7a032db2-8f1e-4988-96f8-bc60b684e864",
          "Code": "sample string 1",
          "Description": "sample string 2",
          "SourceSystemId": "sample string 3",
          "CompanyId": "e07579bd-a8a7-4ca4-a08e-d64f3fd30491",
          "CreateDate": "2026-08-11T22:23:15.553612-07:00",
          "CreateUser": "sample string 5",
          "LastModifiedDate": "2026-08-11T22:23:15.553612-07:00",
          "LastModifiedUser": "sample string 6"
        },
        "DisplayOrder": 1,
        "MinValue": 1.0,
        "MaxValue": 1.0,
        "MinLength": 1,
        "MaxLength": 1,
        "HasValidValues": true,
        "ValidValues": [
          {
            "ValidValueId": "7fd6f1f0-7762-4089-b369-7661d725da49",
            "FieldId": "fba0d35d-c708-4cf0-bb76-092d8ba40e4f",
            "FieldName": "sample string 1",
            "FieldLable": "sample string 2",
            "ValueText": "sample string 3",
            "LabelText": "sample string 4"
          },
          {
            "ValidValueId": "7fd6f1f0-7762-4089-b369-7661d725da49",
            "FieldId": "fba0d35d-c708-4cf0-bb76-092d8ba40e4f",
            "FieldName": "sample string 1",
            "FieldLable": "sample string 2",
            "ValueText": "sample string 3",
            "LabelText": "sample string 4"
          }
        ],
        "ValueExpression": "sample string 5",
        "RequiredExpression": "sample string 6",
        "IsAttachment": true,
        "DefaultValueExpression": "sample string 8",
        "IsAccumulator": true,
        "IsMultiline": true,
        "IsRepeatable": true,
        "VisibleExpression": "sample string 12",
        "SourceSystemId": "sample string 13"
      }
    ],
    "SourceSystemId": "sample string 3",
    "CompanyId": "704b9f39-1584-44fe-9382-0dec26f7d6b1",
    "CreateDate": "2026-08-11T22:23:15.553612-07:00",
    "CreateUser": "sample string 5",
    "LastModifiedDate": "2026-08-11T22:23:15.553612-07:00",
    "LastModifiedUser": "sample string 6"
  },
  "Total": 1,
  "Message": "sample string 1"
}