Create a custom property structure item

Required scopes:

• custom-property-structures:write

Creates custom properties structure items.

After creating a structure item, you cannot change its name and type.

To add data to the custom properties, use the API call to fill in custom properties data.

POSThttps://eu1.make.com/api/v2/custom-property-structures/{customPropertyStructureId}/custom-property-structure-items

Authorization

token

Path parameters

customPropertyStructureId*integer

The ID of the custom property structure. Use the API call GET /custom-property-structures?organizationId={organizationId} to get the ID of a custom property structure.

Example: 2

Body

application/json

name*string

The ID of the structure item. The name has to be unique in the custom properties structure.

label*string

Make displays the item label to users in the scenario table header.

descriptionstring

The description of the custom property structure item. You can review the item description in the Scenario properties tab in the Organization dashboard.

type*enum

The data type of the custom property structure item. The data types dropdown and multiselect allow you to specify available options for the item data.

booleannumbershortTextlongTextdatedropdownmultiselect

optionsany

The options available to users when filling in the item data. For the data types dropdown and multiselect, fill in an object like {"options":[{"value": "Marketing"}, {"value": "Sales"}]}. You can omit the options parameter for the rest of the data types.

requiredboolean

Set to true in order to make a structure item required when adding custom property data. Default value is false.

Response

200

Successful response

Body

application/json

customPropertyStructureItemobject

Request

JavaScriptCurlPython

const response = await fetch('https://eu1.make.com/api/v2/custom-property-structures/{customPropertyStructureId}/custom-property-structure-items', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "teamLocation",
      "label": "Team location",
      "description": "<p>Location of the team managing the scenario.</p>",
      "type": "shortText",
      "required": true,
      "__$markdownParsed": true
    }),
});
const data = await response.json();

Response

200

{
  "customPropertyStructureItem": {
    "id": 0,
    "created": "2025-01-21T11:45:11.624Z",
    "belongers": [
      {
        "belongerId": 0,
        "belongerType": "text",
        "associatedTypes": [
          "text"
        ]
      }
    ]
  }
}