All pages
Powered by GitBook
1 of 1

Loading...

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
/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
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.

Get public (approved) template details

get
/templates/public/{templateUrl}

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

Required scopes
This endpoint requires the following scopes:
Authorizations
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

Get public (approved) template blueprint

get
/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
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
200

Successful response

Responses
200

Successful response

application/json
get
/templates/public/{templateUrl}
200

Successful response

Responses
200

Successful response

application/json
get
/templates/public/{templateUrl}/blueprint
200

Successful response

GET /api/v2/templates/public HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*
GET /api/v2/templates/public/{templateUrl} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*
GET /api/v2/templates/public/{templateUrl}/blueprint HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*
{
  "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
  }
}
{
  "templatePublic": {
    "id": 18,
    "name": "Multiple apps template example",
    "description": null,
    "url": "16-multiple-apps-template-example",
    "usedApps": [
      "discord",
      "http",
      "tools",
      "util",
      "gmail"
    ],
    "usage": 52
  }
}
{
  "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"
}