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

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/scenarios-folders

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

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

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.

Query parameters

teamIdintegerRequired

Unique ID of the Team.

Example: 1

Responses

200

Successful response

application/json

get

/scenarios-folders

HTTPcURLJavaScriptPython

GET /api/v2/scenarios-folders?teamId=1 HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

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

Create scenario folder

post

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/scenarios-folders

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

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

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.

Body

application/json

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

/scenarios-folders

HTTPcURLJavaScriptPython

POST /api/v2/scenarios-folders HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
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

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/scenarios-folders/{folderId}

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

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

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.

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

/scenarios-folders/{folderId}

HTTPcURLJavaScriptPython

DELETE /api/v2/scenarios-folders/{folderId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "scenarioFolder": 123
}

Update scenario folder

patch

https://eu1.make.com/api/v2https://eu2.make.com/api/v2https://us1.make.com/api/v2https://us2.make.com/api/v2https://eu1.make.celonis.com/api/v2https://us1.make.celonis.com/api/v2

/scenarios-folders/{folderId}

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.

Required scopes

This endpoint requires the following scopes:

Authorizations

token

AuthorizationstringRequired

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.

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

application/json

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

/scenarios-folders/{folderId}

HTTPcURLJavaScriptPython

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: 16

{
  "name": "BRAVO"
}

200

Folder updated

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