Scenarios > Custom properties data

The following endpoints allow you to manage custom scenario properties data.

To use custom properties, you have to:

1. Create a custom properties structure.

2. Create custom properties structure items.

3. Fill the items with data.

Read more about custom properties in the custom properties feature documentation.

Get custom properties data

get

Gets custom properties data of the specified scenario.

Authorizations

Path parameters

scenarioIdintegerrequired

The ID of the scenario.

Example: 22

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://eu1.make.com/api/v2/scenarios/{scenarioId}/custom-properties' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "customProperties": {
    "category": [
      "notifications",
      "routing"
    ],
    "customId": 45,
    "location": "London, UK",
    "companyTeam": "Product",
    "description": "This scenario handles notifications for the Product team in London.",
    "highPriority": true,
    "performanceCheck": "2023-08-31T14:19:00.000Z"
  },
  "scenarioId": 22
}

Successful response

Fill in custom properties data

post

Fills in custom properties data for the specified scenario. The scenario has to have no custom properties data.

The data you fill in has to conform to the current custom scenario properties structure. You have to specify a value for every required item, otherwise you get an error.

To update existing data, use the following API calls:

• Update custom properties data

• Set custom properties data

Authorizations

Path parameters

scenarioIdintegerrequired

The ID of the scenario.

Example: 80

Body

objectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://eu1.make.com/api/v2/scenarios/{scenarioId}/custom-properties' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "companyTeam": "marketing",
    "customId": 60,
    "performanceCheck": "2024-09-31T14:19:00.000Z",
    "category": [
      "eshop"
    ],
    "highPriority": false,
    "location": "Chicago, US",
    "description": "Scenario for the Marketing team to share information with other stakeholders."
  }'

200

200

{
  "customProperties": {
    "category": [
      "eshop"
    ],
    "customId": 60,
    "location": "Chicago, US",
    "companyTeam": "marketing",
    "description": "Scenario for the Marketing team to share information with other stakeholders.",
    "highPriority": false,
    "performanceCheck": "2024-10-01T14:19:00.000Z"
  },
  "scenarioId": 80
}

Successful response

Set custom properties

put

Sets custom properties data for the specified scenario. Make replaces the original data with the data you send in the request body.

You have to specify a value for every required custom properties structure item, otherwise you get an error.

The scenario has to have custom property data already. The new data set has to conform to the current custom scenario properties structure. If the initial data is empty, then the API call returns an error.

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

Authorizations

Path parameters

scenarioIdintegerrequired

The ID of the scenario.

Example: 80

Body

objectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://eu1.make.com/api/v2/scenarios/{scenarioId}/custom-properties' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "companyTeam": "engineering",
    "customId": 50,
    "performanceCheck": "2024-08-31T14:19:00.000Z",
    "category": [
      "notifications",
      "routing"
    ],
    "highPriority": false,
    "location": "London, UK",
    "description": "Scenario for the London engineering team"
  }'

200

200

{
  "customProperties": {
    "category": [
      "notifications",
      "routing"
    ],
    "customId": 50,
    "location": "London, UK",
    "companyTeam": "engineering",
    "description": "Scenario for the London engineering team",
    "highPriority": false,
    "performanceCheck": "2024-08-31T14:19:00.000Z"
  },
  "scenarioId": 80
}

Successful response

Delete custom properties data

delete

Deletes custom properties data. Deleting custom properties data is irreversible. Use the confirmed parameter to confirm deleting the data, otherwise you get an error and the data are not deleted.

Authorizations

Path parameters

scenarioIdintegerrequired

The ID of the scenario.

Example: 28

Query parameters

confirmedbooleanoptionalExample: true

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://eu1.make.com/api/v2/scenarios/{scenarioId}/custom-properties' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "ok": 1
}

Successful response

Update custom properties data

patch

Updates custom properties data of the specified scenario. Make updates only the custom properties data you specify in the request body.

The custom property has to contain data already. The update data have to conform to the current custom scenario properties structure. If the initial value is empty, then the API call returns an error.

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

Authorizations

Path parameters

scenarioIdintegerrequired

The ID of the scenario.

Example: 80

Body

objectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url 'https://eu1.make.com/api/v2/scenarios/{scenarioId}/custom-properties' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "customId": 48,
    "location": "Wien, AUS"
  }'

Update item dataUpdate options

200

200

basic-example

options-example

basic-example

{
  "customProperties": {
    "category": [
      "eshop",
      "products"
    ],
    "customId": 48,
    "location": "Wien, AUS",
    "companyTeam": "Product",
    "description": "This scenario is handling notifications for the Product team in London.",
    "highPriority": true,
    "performanceCheck": "2023-08-31T14:19:00.000Z"
  },
  "scenarioId": 80
}

Successful response