Keys

The following endpoints allow you to manage and retrieve metadata for authentication keys in your custom keychain. You can use these keys to manage your authentication in the HTTP or encryptor apps similarly to other connections.

List keys

get

Gets the list of keys in your custom keychain. You can use the typeName query parameter to filter your keys based on their type. Run the list of key types API call to get a list of available key types.

Authorizations

Query parameters

teamIdintegerRequired

The ID of the team.

Example: 22

typeNamestring · enumOptional

Use the key type to get only keys with the specified type. You can use the API call GET /keys/types to list available key types.

Example: basicauthAvailable options:

cols[]string · enum[]Optional

Specifies columns that are returned in the response. Use the cols[] parameter for each column that you want included. For example GET /endpoint?cols[]=key1&cols[]=key2 to get both key1 and key2 columns in the response.

Check the "Filtering" section for a full example.

Example: {"value":["id","name","typeName","teamId","packageName","theme"]}

Responses

application/json

objectOptional

get

HTTPcURLJavaScriptPython

GET /api/v2/keys HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*

200

Successful response

{
  "keys": [
    {
      "id": 1,
      "name": "My HTTP Basic Auth key"
    },
    {
      "id": 2,
      "name": "My HTTP Basic Auth key"
    }
  ]
}

Create a key

post

Creates a key in your keychain.

Use the list of key types API call to get a list of available key types for the typeName parameter. Specify additional parameters in the parameters object based on the key type.

Authorizations

Body

teamIdintegerRequired

The ID of the team.

namestringRequired

The name of the key.

typeNamestringRequired

Use the key type to get only keys with the specified type. You can use the API call GET /keys/types to list available key types.

parametersobjectRequired

Additional parameters required to create the key.

Check the list of key types API call for the parameters you need to specify.

Responses

application/json

objectOptional

post

HTTPcURLJavaScriptPython

POST /api/v2/keys HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "teamId": 22,
  "name": "My HTTP Basic Auth key",
  "typeName": "basicauth",
  "parameters": {
    "authUser": "Martin",
    "authPass": "your-password"
  }
}

basicauthapikeyauth

200

Successful response

{
  "key": {
    "id": 17,
    "name": "Basic Auth",
    "typeName": "basicauth",
    "teamId": 22,
    "packageName": null,
    "theme": "#007ee5"
  }
}

List key types

get

Gets the list of available key types.

Authorizations

Responses

application/json

objectOptional

get

HTTPcURLJavaScriptPython

GET /api/v2/keys/types HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*

200

Successful response

{
  "keysTypes": [
    {
      "name": "aes-key",
      "label": "AES",
      "parameters": [
        {
          "name": "key",
          "type": "text",
          "label": "Key",
          "required": true
        },
        {
          "name": "keyEncoding",
          "label": "Key Encoding",
          "type": "select",
          "required": true,
          "default": "hex",
          "options": [
            {
              "label": "Base 64",
              "value": "base64"
            },
            {
              "label": "Hexadecimal",
              "value": "hex"
            },
            {
              "label": "Plain Text",
              "value": "plain"
            }
          ]
        }
      ],
      "componentType": "key",
      "author": "Patrik Simek",
      "version": "3.0.12",
      "theme": "#fa6f57",
      "icon": "/img/packages/aes-key.png"
    },
    {
      "name": "apikeyauth",
      "label": "API Key Auth",
      "parameters": [
        {
          "name": "key",
          "label": "Key",
          "type": "password",
          "required": true
        },
        {
          "name": "placement",
          "label": "API Key placement",
          "help": "Define where to place the API Key.",
          "type": "select",
          "required": true,
          "default": "header",
          "options": [
            {
              "label": "In the header",
              "value": "header"
            },
            {
              "label": "In the query string",
              "value": "qs"
            }
          ]
        },
        {
          "name": "name",
          "label": "API Key parameter name",
          "type": "text",
          "default": "X-API-Key",
          "required": true
        }
      ],
      "componentType": "key",
      "author": "Petr Malimanek",
      "version": "3.31.4",
      "theme": "#007ee5",
      "icon": "/img/packages/apikeyauth.png"
    },
    {
      "label": "Apple Push Notifications",
      "name": "apn",
      "parameters": [
        {
          "label": "Private Key",
          "multiline": true,
          "required": true,
          "type": "pkey",
          "name": "privateKey",
          "help": "If you're using Provider Authentication Tokens, insert content of acquired .p8 file."
        },
        {
          "label": "Authentication method",
          "name": "method",
          "type": "select",
          "default": "tokens",
          "options": [
            {
              "label": "Provider Authentication Tokens",
              "value": "tokens",
              "nested": [
                {
                  "label": "Key ID",
                  "required": true,
                  "type": "text",
                  "name": "keyId"
                },
                {
                  "label": "Team ID",
                  "required": true,
                  "type": "text",
                  "name": "teamId"
                }
              ]
            },
            {
              "label": "Certificate",
              "value": "cert",
              "nested": [
                {
                  "label": "Certificate",
                  "required": true,
                  "multiline": true,
                  "type": "cert",
                  "name": "certificate"
                }
              ]
            }
          ]
        },
        {
          "required": true,
          "label": "Production",
          "default": false,
          "name": "production",
          "type": "boolean"
        }
      ],
      "componentType": "key",
      "author": "Patrik Simek",
      "version": "1.1.6",
      "theme": "#666666",
      "icon": "/img/packages/apn.png"
    },
    {
      "name": "basicauth",
      "label": "HTTP Basic Auth",
      "parameters": [
        {
          "name": "authUser",
          "label": "Username",
          "type": "text"
        },
        {
          "name": "authPass",
          "label": "Password",
          "type": "password"
        }
      ],
      "componentType": "key",
      "author": "Petr Malimanek",
      "version": "3.31.4",
      "theme": "#007ee5",
      "icon": "/img/packages/basicauth.png"
    }
  ]
}

Get key details

get

Gets details of the specified key.

Authorizations

Path parameters

keyIdintegerRequired

The ID of the key.

Example: 16

Query parameters

cols[]string · enum[]Optional

Specifies columns that are returned in the response. Use the cols[] parameter for every column that you want to return in the response. For example GET /endpoint?cols[]=key1&cols[]=key2 to get both key1 and key2 columns in the response.

Check the "Filtering" section for a full example.

Example: {"value":["id","name","typeName","teamId","packageName","theme"]}

Responses

application/json

objectOptional

get

HTTPcURLJavaScriptPython

GET /api/v2/keys/{keyId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*

200

Successful response

{
  "key": {
    "id": 1,
    "name": "My secret key"
  }
}

Delete a key

delete

Deletes the specified key. Use the confirmed parameter to confirm deleting the key. Otherwise, you get an error and the key is not deleted.

Authorizations

Path parameters

keyIdintegerRequired

The ID of the key.

Example: 16

Query parameters

confirmedbooleanOptional

Set this parameter to true to confirm deleting the key. Otherwise, you get an error and the key is not deleted.

Example: true

Responses

application/json

objectOptional

delete

HTTPcURLJavaScriptPython

DELETE /api/v2/keys/{keyId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*

200

Successful response

{
  "key": 16
}

Update a key

patch

Updates a key name, connection parameters, or both with the data specified in the request body. If you don't specify a parameter, Make keeps the original value.

Use the GET /key-types API call to find out which parameters you need to specify in the parameters object based on the key type.

Authorizations

Path parameters

keyIdintegerRequired

The ID of the key.

Example: 16

Body

objectOptional

Responses

application/json

objectOptional

patch

HTTPcURLJavaScriptPython

PATCH /api/v2/keys/{keyId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "name": "Updated basic auth key"
}

update-nameupdate-connection

200

Successful response

{
  "key": {
    "id": 16,
    "name": "Updated basic auth key",
    "typeName": "basicauth",
    "teamId": 22,
    "packageName": null,
    "theme": "#007ee5"
  }
}