Templates

The Templates feature allows you to create and use templates as a starting point for your Make scenarios. By default, Make offers hundreds of templates containing the scenarios of most-used apps. The following endpoints allow you to create and manage templates.

List 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

Retrieves a collection of all templates for a team with a given ID. Returned templates are sorted by ID 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

teamIdintegerOptional

The unique ID of the team whose templates will be retrieved.

Example: 1

publicbooleanOptional

Indicates if the template is public which means that it was published and approved, and can be accessed by anyone.

Example: true

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

HTTPcURLJavaScriptPython

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

200

Successful response

{
  "templates": [
    {
      "id": 61,
      "name": "Private",
      "teamId": 1,
      "description": "Template description",
      "usedApps": [
        "http"
      ],
      "public": false,
      "published": null,
      "approved": null,
      "approvedId": null,
      "requestedApproval": false,
      "publishedId": null,
      "publicUrl": null,
      "approvedName": null,
      "publishedName": null
    },
    {
      "id": 65,
      "name": "Published",
      "teamId": 1,
      "description": null,
      "usedApps": [
        "http"
      ],
      "public": true,
      "published": "2020-12-01T14:14:53.807Z",
      "approved": null,
      "approvedId": null,
      "requestedApproval": false,
      "publishedId": 39,
      "publicUrl": "39-published",
      "approvedName": null,
      "publishedName": "Published"
    },
    {
      "id": 56,
      "name": "Published, approved",
      "teamId": 1,
      "description": null,
      "usedApps": [
        "http"
      ],
      "public": true,
      "published": "2020-11-10T14:08:29.084Z",
      "approved": "2020-12-03T09:44:55.685Z",
      "approvedId": 35,
      "requestedApproval": false,
      "publishedId": null,
      "publicUrl": "32-published-approved",
      "approvedName": "Published, approved",
      "publishedName": null
    },
    {
      "id": 64,
      "name": "Published, approved, waiting for approval",
      "teamId": 1,
      "description": null,
      "usedApps": [
        "http"
      ],
      "public": true,
      "published": "2020-12-01T15:18:31.790Z",
      "approved": "2020-12-02T09:44:42.045Z",
      "approvedId": 38,
      "requestedApproval": true,
      "publishedId": 40,
      "publicUrl": "37-published-approved-waiting-for-approval",
      "approvedName": "Published, approved, waiting for approval",
      "publishedName": "Published, approved, waiting for approval"
    },
    {
      "id": 62,
      "name": "Published, waiting for approval",
      "teamId": 1,
      "description": null,
      "usedApps": [
        "http"
      ],
      "public": true,
      "published": "2020-11-23T12:22:36.495Z",
      "approved": null,
      "approvedId": null,
      "requestedApproval": true,
      "publishedId": 36,
      "publicUrl": "36-published-waiting-for-approval",
      "approvedName": null,
      "publishedName": "Published, waiting for approval"
    }
  ],
  "pg": {
    "sortBy": "name",
    "limit": 10,
    "sortDir": "asc",
    "offset": 0
  }
}

Create template

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

/templates

Creates a new template with data passed in the request body. In the response, it returns all details of the created template.

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

Body

application/json

teamIdintegerOptional

The unique numeric ID of the team in which the template will be created.

languagestringOptional

The language of the template determining in which language template details such as module names will be displayed. This property also impacts the visibility of the created template and cannot be changed later.

Responses

200

Successful response

application/json

post

/templates

HTTPcURLJavaScriptPython

POST /api/v2/templates HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 1104

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

200

Successful response

{
  "template": {
    "id": 67,
    "name": "New template",
    "teamId": 1,
    "description": null,
    "usedApps": [
      "http"
    ],
    "public": false,
    "published": null,
    "approved": null,
    "approvedId": null,
    "requestedApproval": false,
    "publishedId": null,
    "publicUrl": null,
    "approvedName": null,
    "publishedName": null
  }
}

Get 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/{templateId}

Retrieves details of a template with a given ID.

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

templateIdintegerRequired

The unique ID of the private template. It can be retrieved from the List templates endpoint.

Example: 164

Query parameters

Responses

200

Successful response

application/json

get

/templates/{templateId}

HTTPcURLJavaScriptPython

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

200

Successful response

{
  "template": {
    "id": 164,
    "name": "Published, approved, waiting for approval"
  }
}

Delete template

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

/templates/{templateId}

Deletes a template 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

templateIdintegerRequired

The unique ID of the private template. It can be retrieved from the List templates endpoint.

Example: 164

Query parameters

confirmedbooleanOptional

Confirms the deletion of the private or published template. If the parameter is missing or it is set to false an error code is returned and the resource is not deleted. The public (approved) templates can only be deleted by administrators.

Example: true

Responses

200

Successful response

application/json

templateintegerOptional

delete

/templates/{templateId}

HTTPcURLJavaScriptPython

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

200

Successful response

{
  "template": 164
}

Update template

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

/templates/{templateId}

Updates a template 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 template 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

templateIdintegerRequired

The unique ID of the private template. It can be retrieved from the List templates endpoint.

Example: 164

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

Body

application/json

namestringOptional

The new name of the template. The name does not need to be unique.

Responses

200

Successful response

application/json

patch

/templates/{templateId}

HTTPcURLJavaScriptPython

PATCH /api/v2/templates/{templateId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 1102

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

200

Successful response

{
  "template": [
    {
      "id": 164,
      "name": "Renamed template",
      "teamId": 1,
      "description": null,
      "usedApps": [
        "http"
      ],
      "public": false,
      "published": null,
      "approved": null,
      "approvedId": null,
      "requestedApproval": false,
      "publishedId": null,
      "publicUrl": null,
      "approvedName": null,
      "publishedName": null
    }
  ]
}

Get 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/{templateId}/blueprint

Retrieves a blueprint of a template with a given ID.

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

templateIdintegerRequired

The unique ID of the private template. It can be retrieved from the List templates endpoint.

Example: 164

Query parameters

forUsebooleanOptional

If this parameter is set to true, it means the blueprint should be used for creating a scenario from the template.

Example: true

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/{templateId}/blueprint

HTTPcURLJavaScriptPython

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

200

Successful response

{
  "blueprint": {
    "flow": [
      {
        "id": 1,
        "mapper": {
          "url": "https://seznam.cz",
          "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
      }
    }
  },
  "controller": {
    "name": "Template name",
    "modules": {},
    "idSequence": 2
  },
  "scheduling": {
    "type": "indefinitely",
    "interval": 1000
  },
  "language": "en"
}

Publish template

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

/templates/{templateId}/publish

Publishes a private template with a given ID. In the response, it returns all details of the template.

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

templateIdintegerRequired

The unique ID of the private template. It can be retrieved from the List templates endpoint.

Example: 164

Query parameters

Body

Responses

200

Successful response

application/json

post

/templates/{templateId}/publish

HTTPcURLJavaScriptPython

POST /api/v2/templates/{templateId}/publish HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "template": {
    "id": 164,
    "name": "Renamed template",
    "teamId": 1,
    "description": null,
    "usedApps": [
      "http"
    ],
    "public": true,
    "published": "2020-12-03T14:11:08.327Z",
    "approved": null,
    "approvedId": null,
    "requestedApproval": false,
    "publishedId": 48,
    "publicUrl": "48-renamed-template",
    "approvedName": null,
    "publishedName": "Renamed template"
  }
}

Request approval

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

/templates/{templateId}/request-approval

Requests approval of the published template with the given IDs of its private and published versions. In the response, it returns all details of the template.

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

templateIdintegerRequired

The unique ID of the private template. It can be retrieved from the List templates endpoint.

Example: 164

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

post

/templates/{templateId}/request-approval

HTTPcURLJavaScriptPython

POST /api/v2/templates/{templateId}/request-approval HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "template": {
    "id": 164,
    "name": "Renamed template",
    "teamId": 1,
    "description": null,
    "usedApps": [
      "http"
    ],
    "public": true,
    "published": "2020-12-03T14:11:08.327Z",
    "approved": null,
    "approvedId": null,
    "requestedApproval": true,
    "publishedId": 48,
    "publicUrl": "48-renamed-template",
    "approvedName": null,
    "publishedName": "Renamed template"
  }
}