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

objectOptional

get

HTTPcURLJavaScriptPython

GET /api/v2/scenarios/{scenarioId}/custom-properties HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*

200

Successful response

{
  "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
}

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

objectOptional

post

HTTPcURLJavaScriptPython

POST /api/v2/scenarios/{scenarioId}/custom-properties HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 248

{
  "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

Successful response

{
  "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
}

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

objectOptional

put

HTTPcURLJavaScriptPython

PUT /api/v2/scenarios/{scenarioId}/custom-properties HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 230

{
  "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

Successful response

{
  "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
}

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

objectOptional

delete

HTTPcURLJavaScriptPython

DELETE /api/v2/scenarios/{scenarioId}/custom-properties HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*

200

Successful response

{
  "ok": 1
}

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

objectOptional

patch

HTTPcURLJavaScriptPython

PATCH /api/v2/scenarios/{scenarioId}/custom-properties HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "customId": 48,
  "location": "Wien, AUS"
}

Update item dataUpdate options

200

Successful response

{
  "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
}