Scenarios folders

Scenarios can be grouped into folders for better organization. The following endpoints allow you to create and manage scenarios folders.

List scenario folders

get

Retrieves a collection of all scenarios folders for a team with a given ID. Returned folders are sorted by name in ascending order.

Authorizations
Query parameters
teamIdintegerRequired

Unique ID of the Team.

Example: 1
Responses
200
Successful response
application/json
get
GET /api/v2/scenarios-folders HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "scenariosFolders": [
    {
      "id": 1576,
      "name": "ALPHA",
      "scenariosTotal": 10
    }
  ]
}

Create scenario folder

post

Creates a new scenario folder with data passed in the request body. As the response, it returns all details of the created scenario folder.

Authorizations
Body
namestringRequired

The name of the scenario folder. The name must be at most 100 characters long and does not need to be unique.

teamIdintegerRequired

The unique ID of the team in which the scenario folder will be created.

Responses
200
Created a Folder
application/json
post
POST /api/v2/scenarios-folders HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "name": "ZULU",
  "teamId": 123
}
200

Created a Folder

{
  "scenarioFolder": {
    "id": 1576,
    "name": "ALPHA",
    "scenariosTotal": 10
  }
}

Delete scenario folder

delete

Deletes a scenario folder with a given ID and returns the ID in the response.

Authorizations
Path parameters
folderIdintegerRequired

The unique ID of the scenario folder. It can be retrieved from the List scenarios folders endpoint.

Example: 1
Responses
200
Successful response
application/json
delete
DELETE /api/v2/scenarios-folders/{folderId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "scenarioFolder": 123
}

Update scenario folder

patch

Updates a scenario folder with a given ID by passing new values in the request body. Any property that is not provided will be left unchanged. In the response, it returns all details of the updated folder including properties that were not changed.

Authorizations
Path parameters
folderIdintegerRequired

The unique ID of the scenario folder. It can be retrieved from the List scenarios folders endpoint.

Example: 1
Query parameters
Body
namestringOptional

The name for the updated scenario folder. The name must be at most 100 characters long and does not need to be unique.

Responses
200
Folder updated
application/json
patch
PATCH /api/v2/scenarios-folders/{folderId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "name": "BRAVO"
}
200

Folder updated

{
  "scenarioFolder": {
    "id": 1576,
    "name": "ALPHA",
    "scenariosTotal": 10
  }
}