Ctrlk
Get support
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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
/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
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. Templates can be currently sorted only by ID or name.

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

Retrieves details of a template with a given ID.

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
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}
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
/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
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}
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
/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
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
namestringOptional

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

Responses
200

Successful response

application/json
patch/templates/{templateId}
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
/templates/{templateId}/blueprint

Retrieves a blueprint of a template with a given ID.

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
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
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
/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
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
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
/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
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
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"
  }
}
PreviousUser team rolesNextPublic

Last updated