Scenarios Folders
Scenarios can be grouped into folders for better organization. The following endpoints allow you to create and manage scenarios folders.
Retrieves direct scenario folder children for a team or organization. Provide teamId or organizationId. If both are provided, teamId is used. Omit parentId to return top-level folders.
Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.
If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.
Unique ID of the Team.
1The unique ID of the organization whose scenario folders should be returned.
The parent folder whose direct children should be returned. Omit to return top-level folders.
Set to all to return all descendants under children. By default, children includes only one direct child level.
Successful response
GET /api/v2/scenarios-folders?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*
Successful response
{
"scenariosFolders": [
{
"id": 1576,
"name": "ALPHA",
"path": "ALPHA",
"parentId": null,
"position": null,
"scenariosTotal": 10,
"scenariosSubtreeTotal": 10,
"hasChildren": false,
"children": []
}
]
}Creates a new scenario folder with data passed in the request body. As the response, it returns all details of the created scenario folder.
Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.
If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.
The name of the scenario folder. The name must be at most 100 characters long and does not need to be unique.
The unique ID of the team in which the scenario folder will be created.
The unique ID of the parent scenario folder. Omit or pass null to create a top-level folder.
Created a Folder
POST /api/v2/scenarios-folders HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 44
{
"name": "ZULU",
"teamId": 123,
"parentId": null
}Created a Folder
{
"scenarioFolder": {
"id": 1576,
"name": "ALPHA",
"path": "ALPHA",
"parentId": null,
"position": null,
"scenariosTotal": 10,
"scenariosSubtreeTotal": 10,
"hasChildren": false,
"children": []
}
}Moves selected scenarios from the specified team into a target folder. Use targetFolderId: null to uncategorize them.
Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.
If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.
The team that owns all scenarios and the target folder.
The scenario IDs to move.
The target folder ID. Use null to uncategorize the scenarios.
Scenarios moved
POST /api/v2/scenarios-folders/move-scenarios HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 60
{
"teamId": 123,
"scenarioIds": [
123,
456
],
"targetFolderId": 1576
}Scenarios moved
{
"movedScenarioIds": [
123,
456
],
"targetFolderId": 1576
}Sets manual positions for direct sibling folders within one parent. Omitted siblings have their position cleared and are listed alphabetically after positioned folders.
Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.
If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.
The team that owns the sibling folder set.
The parent folder whose direct children are being reordered. Omit or pass null for top-level folders.
Folder IDs in the desired order. All folders must be direct siblings under parentId. Omitted sibling folders have their position cleared.
Scenario folders reordered
POST /api/v2/scenarios-folders/reorder HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 54
{
"teamId": 123,
"parentId": null,
"folderIds": [
1576,
1577
]
}Scenario folders reordered
{
"reorderedFolderIds": [
1576,
1577
],
"parentId": null
}Deletes a scenario folder with a given ID and returns the ID in the response. Scenarios in the deleted folder and its subfolders are moved to the deleted folder's parent, or uncategorized when deleting a top-level folder. Descendant folders are deleted.
Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.
If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.
The unique ID of the scenario folder. It can be retrieved from the List scenarios folders endpoint.
1Successful response
DELETE /api/v2/scenarios-folders/{folderId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*
Successful response
{
"scenarioFolder": 123
}Updates a scenario folder with a given ID by passing a new name, a new parent folder, or both in the request body. Use parentId null to move the folder to the top level. 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.
Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.
If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.
The unique ID of the scenario folder. It can be retrieved from the List scenarios folders endpoint.
1The name for the updated scenario folder. The name must be at most 100 characters long and does not need to be unique.
The unique ID of the new parent scenario folder. Use null to move the folder to the top level.
Folder updated
PATCH /api/v2/scenarios-folders/{folderId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 32
{
"name": "BRAVO",
"parentId": null
}Folder updated
{
"scenarioFolder": {
"id": 1576,
"name": "ALPHA",
"path": "ALPHA",
"parentId": null,
"position": null,
"scenariosTotal": 10,
"scenariosSubtreeTotal": 10,
"hasChildren": false,
"children": []
}
}Last updated