Templates > Public

The following endpoints focus on the public (approved) templates that are available to every user regardless of the organization and team.

List public (approved) templates

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

/templates/public

Retrieves a collection of all public (approved) templates that are available for anyone. Returned templates are sorted by usage in descending 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

includeEnbooleanOptional

If this parameter is set to true, it means English templates should be included in the response. This is relevant only if the user's language is not English.

Example: true

namestringOptional

The name of the template. This parameter allows limiting returned results to the template(s) with the given name.

Example: my first template

usedApps[]string[]Optional

The array with the text IDs of the apps used in the templates. This parameter allows you to get only the templates containing specific apps.

Example: ["http"]

pg[sortBy]stringOptional

The value that will be used to sort returned entities by.

pg[offset]integerOptional

The value of entities you want to skip before getting entities you need.

pg[sortDir]string · enumOptional

The sorting order. It accepts the ascending and descending direction specifiers.

Possible values:

pg[limit]integerOptional

Sets the maximum number of results per page in the API call response. For example, pg[limit]=100. The default number varies with different API endpoints.

Responses

200

Successful response

application/json

get

/templates/public

HTTPcURLJavaScriptPython

GET /api/v2/templates/public HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "templatesPublic": [
    {
      "id": 13,
      "name": "Http template example",
      "description": null,
      "url": "13-http-template-example",
      "usedApps": [
        "http"
      ],
      "usage": 321
    },
    {
      "id": 17,
      "name": "Multiple apps template example",
      "description": null,
      "url": "16-multiple-apps-template-example",
      "usedApps": [
        "discord",
        "http",
        "tools",
        "util",
        "gmail"
      ],
      "usage": 52
    }
  ],
  "pg": {
    "sortBy": "usage",
    "limit": 100,
    "sortDir": "desc",
    "offset": 0
  }
}

Get public (approved) template details

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

/templates/public/{templateUrl}

Retrieves details of a public (approved) template with a given publicUrl.

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

templateUrlstringRequired

The unique URL of the public (approved) template consisting of the template ID and name. It can be retrieved from the List templates endpoint.

Example: 16-multiple-apps-template-example

Query parameters

templatePublicIdintegerOptional

The unique ID of the public version of the approved template. It can be retrieved from the List templates endpoint as one of the following IDs: publishedId for all published templates that are waiting for approval or not, or approvedId for approved templates.

Example: 18

Responses

200

Successful response

application/json

get

/templates/public/{templateUrl}

HTTPcURLJavaScriptPython

GET /api/v2/templates/public/{templateUrl} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "templatePublic": {
    "id": 18,
    "name": "Multiple apps template example",
    "description": null,
    "url": "16-multiple-apps-template-example",
    "usedApps": [
      "discord",
      "http",
      "tools",
      "util",
      "gmail"
    ],
    "usage": 52
  }
}

Get public (approved) template blueprint

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

/templates/public/{templateUrl}/blueprint

Retrieves a blueprint of a public (approved) template with a given publicUrl.

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

templateUrlstringRequired

The unique URL of the public (approved) template consisting of the template ID and name. It can be retrieved from the List templates endpoint.

Example: 16-multiple-apps-template-example

Query parameters

templatePublicIdintegerOptional

The unique ID of the public version of the approved template. It can be retrieved from the List templates endpoint as one of the following IDs: publishedId for all published templates that are waiting for approval or not, or approvedId for approved templates.

Example: 18

Responses

200

Successful response

application/json

languagestringOptional

get

/templates/public/{templateUrl}/blueprint

HTTPcURLJavaScriptPython

GET /api/v2/templates/public/{templateUrl}/blueprint HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "blueprint": {
    "flow": [
      {
        "id": 1,
        "mapper": {
          "url": "https://google.com",
          "method": "get",
          "shareCookies": false
        },
        "module": "http:ActionGetFile",
        "version": 3,
        "metadata": {
          "expect": [
            {
              "name": "url",
              "type": "url",
              "label": "URL",
              "required": true
            },
            {
              "name": "method",
              "type": "hidden",
              "label": "Method"
            },
            {
              "name": "shareCookies",
              "type": "boolean",
              "label": "Share cookies with other HTTP modules",
              "required": true
            }
          ],
          "designer": {
            "x": 0,
            "y": 0
          },
          "parameters": [
            {
              "name": "handleErrors",
              "type": "boolean",
              "label": "Evaluate all states as errors (except for 2xx and 3xx )",
              "required": true
            }
          ]
        },
        "parameters": {
          "handleErrors": false
        }
      }
    ],
    "metadata": {
      "version": 1,
      "designer": {
        "orphans": []
      },
      "scenario": {
        "dlq": false,
        "dataloss": false,
        "maxErrors": 3,
        "autoCommit": true,
        "roundtrips": 1,
        "sequential": false,
        "confidential": false,
        "autoCommitTriggerLast": true,
        "freshVariables": false
      }
    }
  },
  "controller": {
    "name": "New template",
    "modules": {},
    "idSequence": 2
  },
  "scheduling": {
    "type": "indefinitely",
    "interval": 900
  },
  "language": "en"
}