API reference

Record types

List record types

This endpoint returns the available record types, e.g. movie, organization, person, etc.

Response parameters

Name	Description
name	Name of the record type.
label	Label of the record type.
creatable	The record type supports operation create.
updatable	The record type supports operation update.
readable	The record type supports operation read.
searchable	The record type supports operation search.
searchesIn	The list of parameters to search by in the records of the record type.
deletable	The record type suuports operation delete.
triggerable	The record type supports firing webhooks when a new event is logged. The record type records the date and time of the event.

Endpoint to retrieve available record types.

get

This endpoint retrieves available record types.

Header parameters

authorizationstringrequired

Access token for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://app-academy.make.com/api/v3/recordTypes' \
  --header 'authorization: text'

200

200

{
  "recordTypes": [
    {
      "name": "movie",
      "label": "Movie",
      "creatable": true,
      "updatable": true,
      "readable": true,
      "searchable": true,
      "searchesIn": [
        "text"
      ],
      "deletable": true
    }
  ]
}

OK

Retrieves a record type.

get

This endpoint retrieves JSON file of a record type.

Path parameters

namestringrequired

Name of the record to work with.

Header parameters

authorizationstringrequired

Access token for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://app-academy.make.com/api/v3/recordTypes/{name}' \
  --header 'authorization: text'

200

200

{
  "recordParameters": [
    {
      "name": "id",
      "label": "ID",
      "mandatory": true,
      "readable": true,
      "updatable": true,
      "refersTo": "organization",
      "type": "text",
      "nestedParameters": "[Circular Reference]"
    }
  ]
}

OK

Retrieve a record type

This endpoint retrieves the JSON file of a record type. This JSON file contains the list of parameters available in the record type.

Response parameters

Name	Description
name	Name of the parameter.
label	Label of teh parameter.
mandatory	The parameter is mandatory.
readable	The parameter is returned in the response body when the record is fetched.
updatable	The parameter can be used to create/update a record.
refersTo	Name of the record type to which the parameter refers. Only available for the parameters of type ID.
type	JSON type of the parameter, e.g. text, number, array.
nestedParameters	The parameters that are nested to the parameter.

Retrieves records. E.g. movies.

post

Retrieves records. E.g. movies.

Path parameters

recordTypestringrequired

Type of the record to retrieve, e.g. movie.

Query parameters

offsetnumber

The number of records to skip.

Example: 5

Header parameters

authorizationstringrequired

Access token for authorization.

Body

any

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app-academy.make.com/api/v3/{recordType}/query' \
  --header 'authorization: text' \
  --header 'Content-Type: application/json'

200

200

{
  "totalRecordsReturned": 5,
  "records": [
    {
      "id": "1dca6a93fcf1",
      "name": "Robert Downey Jr.",
      "createdAt": "2023-04-13T17:04:47+00:00",
      "updatedAt": "2023-04-13T17:04:47+00:00"
    }
  ]
}

OK

Records

Retrieves records. E.g. movies.

post

Retrieves records. E.g. movies.

Path parameters

recordTypestringrequired

Type of the record to retrieve, e.g. movie.

Query parameters

offsetnumber

The number of records to skip.

Example: 5

Header parameters

authorizationstringrequired

Access token for authorization.

Body

any

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app-academy.make.com/api/v3/{recordType}/query' \
  --header 'authorization: text' \
  --header 'Content-Type: application/json'

200

200

{
  "totalRecordsReturned": 5,
  "records": [
    {
      "id": "1dca6a93fcf1",
      "name": "Robert Downey Jr.",
      "createdAt": "2023-04-13T17:04:47+00:00",
      "updatedAt": "2023-04-13T17:04:47+00:00"
    }
  ]
}

OK

Filtering records

The search records endpoint supports chained filters. The filter is sent in body of the request.

{
    "or":[
        {
            "and":[
                {
                    "property": "name",
                    "startsWith": "R"    
                },
                {
                    "property": "name",
                    "contains": "o"
                }
            ]
        },
        {
            "and":[
                {
                    "property": "name",
                    "startsWith": "G"
                },
                {
                    "property": "name",
                    "contains": "w"
                }
            ]
        }
    ]
}

In addition to chained filters, records can be queried with single filters as well.

{
    "and":[
        {
            "property": "name",
            "startsWith": "R"
        }
    ]
}

Supported operators for filtering

• startsWith

• endsWith

• contains

• equalsTo

Retrieve a record

Retrieves the record by its ID.

get

Retrieves the record by its ID.

Path parameters

recordTypestringrequired

Type of the record to retrieve, e.g. movie.

idstringrequired

ID of the record to work with.

Header parameters

authorizationstringrequired

Access token for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://app-academy.make.com/api/v3/{recordType}/{id}' \
  --header 'authorization: text'

200

200

No body

OK

Create a record

Each user is granted access to 6 default movie records that cannot be updated or deleted.

Each user can create up to 14 movie records, resulting in 20 retrievable movie records.

Creates a new record. E.g. a movie.

post

Creates a new record. E.g. a movie.

Path parameters

recordTypestringrequired

Type of the record to retrieve, e.g. movie.

Header parameters

authorizationstringrequired

Access token for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app-academy.make.com/api/v3/{recordType}' \
  --header 'authorization: text'

200

200

No body

OK

The body of the request contains the parameters available in the selected record type.

Update a record

Only the records created by the user can be updated.

Updates the record by its ID.

patch

Updates the record by its ID.

Path parameters

recordTypestringrequired

Type of the record to retrieve, e.g. movie.

idstringrequired

ID of the record to work with.

Header parameters

authorizationstringrequired

Access token for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url 'https://app-academy.make.com/api/v3/{recordType}/{id}' \
  --header 'authorization: text'

200

200

No body

OK

The body of the request contains the parameters available in the selected record type.

Delete a record

Only the records created by the user can be deleted.

Deletes the record by its ID.

delete

Deletes the record by its ID.

Path parameters

recordTypestringrequired

Type of the record to retrieve, e.g. movie.

idstringrequired

ID of the record to work with.

Header parameters

authorizationstringrequired

Access token for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://app-academy.make.com/api/v3/{recordType}/{id}' \
  --header 'authorization: text'

200

200

No body

OK

Retrieves the list of files or folders.

get

Retrieves the list of files or folders.

Query parameters

parentstring

ID of the parent to work with.

pagenumber

Identification of the page to retrieve.

Header parameters

authorizationstringrequired

Access token for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://app-academy.make.com/api/v3/files' \
  --header 'authorization: text'

200

200

{
  "totalPages": 2,
  "items": [
    {
      "name": "test.txt",
      "parent": "e4677852dffe",
      "id": "dj789jdj344i",
      "type": "folder"
    }
  ]
}

OK

Files/Folders

Retrieve files or folders

Retrieves the list of files or folders.

get

Retrieves the list of files or folders.

Query parameters

parentstring

ID of the parent to work with.

pagenumber

Identification of the page to retrieve.

Header parameters

authorizationstringrequired

Access token for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://app-academy.make.com/api/v3/files' \
  --header 'authorization: text'

200

200

{
  "totalPages": 2,
  "items": [
    {
      "name": "test.txt",
      "parent": "e4677852dffe",
      "id": "dj789jdj344i",
      "type": "folder"
    }
  ]
}

OK

Download a file

Downloads a file.

get

Downloads a file.

Path parameters

idstringrequired

ID of the record to work with.

Header parameters

authorizationstringrequired

Access token for authorization.

Responses

application/octet-stream

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://app-academy.make.com/api/v3/files/{id}' \
  --header 'authorization: text'

200

200

No body

OK

Delete a file

Deletes a file.

delete

Deletes a file.

Path parameters

idstringrequired

ID of the record to work with.

Header parameters

authorizationstringrequired

Access token for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://app-academy.make.com/api/v3/files/{id}' \
  --header 'authorization: text'

200

200

No body

OK

Upload a file

Each user is granted access to 1 default record that can't be deleted.

Each user can upload up to 1 file, resulting in 2 retrievable files.

The maximum size of a file one can upload to an upload session is 4 bytes. A single request within the upload session cannot exceed 1 byte. Example: If a file has 4 bytes, the file has to be split into 4 separate requests containing a block of data (bytes).

Step one: Open a slot for a file uplod

Open a slot for an upload session and save the file's name and the given file path where the file should be uploaded.

Only one slot can be open at a time. The slot can be open for max 1 minute. The session is dropped if the file upload is not finished by that time or if the upload session ends up with an error.

Creates a session ID for a file upload. Stores a file name and the final location of the file (full path to the folder is required).

post

Creates a session ID for a file upload. Stores a file name and the final location of the file (full path to the folder is required).

Header parameters

authorizationstringrequired

Access token for authorization.

Body

pathstringrequired

Example: /8c6e22b7f1a0/e4673b2dff5e/1dca6a93fcf1

fileNamestringrequired

Example: test.txt

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app-academy.make.com/api/v3/files/upload/openSlot' \
  --header 'authorization: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "path": "/8c6e22b7f1a0/e4673b2dff5e/1dca6a93fcf1",
    "fileName": "test.txt"
  }'

200

200

{
  "session_id": "e4677852dffe"
}

OK

Step two: Upload the first block of data of the file

Upload the first block of data to an uplaod session.

Uploads the first block of data of a file.

post

Uploads the first block of data of a file.

Header parameters

authorizationstringrequired

Access token for authorization.

session-idstringrequired

Session ID of the file upload.

content-typestringrequired

application/octet-stream

Example: application/octet-stream

Body

string · binary

Example: raw(binary)

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app-academy.make.com/api/v3/files/upload/start' \
  --header 'authorization: text' \
  --header 'session-id: text' \
  --header 'content-type: text' \
  --header 'Content-Type: application/octet-stream' \
  --data '"raw(binary)"'

200

200

{
  "session_id": "e4677852dffe"
}

OK

Step three: Upload the other blocks of data of the file

Append more data to an upload session.

Uploads the other blocks of data (bytes) of a file, except the last block of data.

post

Uploads the other blocks of data (bytes) of a file, except the last block of data.

Header parameters

authorizationstringrequired

Access token for authorization.

session-idstringrequired

Session ID of the file upload.

content-typestringrequired

application/octet-stream

Example: application/octet-stream

offsetnumberrequired

Identification of the byte's order in the file to upload.

Body

string · binary

Example: raw(binary)

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app-academy.make.com/api/v3/files/upload/append' \
  --header 'authorization: text' \
  --header 'session-id: text' \
  --header 'content-type: text' \
  --header 'offset: 1' \
  --header 'Content-Type: application/octet-stream' \
  --data '"raw(binary)"'

200

200

{
  "session_id": "e4677852dffe"
}

OK

Step four: Upload the last block of data of the file and close the session

Finish the upload session by uploading the last block (byte) of the file's data.

Uploads the last block of data of a file and closes the session.

post

Uploads the last block of data a file and closes the session.

Header parameters

authorizationstringrequired

Access token for authorization.

session-idstringrequired

Session ID of the file upload.

content-typestringrequired

application/octet-stream

Example: application/octet-stream

Body

string · binary

Example: raw(binary)

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app-academy.make.com/api/v3/files/upload/finish' \
  --header 'authorization: text' \
  --header 'session-id: text' \
  --header 'content-type: text' \
  --header 'Content-Type: application/octet-stream' \
  --data '"raw(binary)"'

200

200

{
  "file_id": "test.txt"
}

OK

Webhooks

Verification of the webhook

The Make Academy API version 3 uses a digital signature which is generated using the secret key entered when creating a webhook and the body of the webhook’s request. This data is contained within the Signature header.

The header contains the SHA algorithm used to generate the signature. To verify that the request originates from the App Academy API, you'll need to compute the HMAC 256 using your secret key and the body and compare it to the signature contained in the header. The successful matching of these values ensures that the webhook's source is the App Academy API.

Example of computing HMAC 256 in JavaScript

import * as crypto from 'crypto';

function generateHMACSHA256(secretKey: string, data: string): string {
    const hmac = crypto.createHmac('sha256', secretKey);
    hmac.update(data);
    return hmac.digest('hex');
}
const secretKey ='yourSecretKey';
const body ='yourBodyContent';

const hmacSHA256 = generateHMACSHA256(secretKey, body);
console.log(`HMAC-SHA256: ${hmacSHA256}`);

Responding to the webhook

You must set up the verification of the webhook.

When a webhook is attached, the verification payload is sent to the webhook. You must respond with the correct HTTP code:

• 200 for correct signature

• 400 for incorrect signature

For the 400 code, you must respond with the following response:

Headers

"Content-type": "application/json"

Body

{
    "message": "Invalid signature"
}

Webhook's payload

Payload parameters

Name	Description
eventType	The type of event that fired the webhook. Available types: verification, create, update.
data	The body of the record type.

{
    "eventType": "verification",
    "data": {...}
}

Attach a webhook

Attaches a new webhook.

post

Attaches a new webhook.

Header parameters

authorizationstringrequired

Access token for authorization.

Body

urlstringrequired

secretKeystringrequired

recordTypestringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app-academy.make.com/api/v3/webhooks' \
  --header 'authorization: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "url": "text",
    "secretKey": "text",
    "recordType": "text"
  }'

200

200

{
  "hookId": "text",
  "secretKey": "text"
}

OK

Detach a webhook

Detaches an existing webhook.

delete

Detaches an existing webhook.

Path parameters

idstringrequired

ID of the record to work with.

Header parameters

authorizationstringrequired

Access token for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://app-academy.make.com/api/v3/webhooks/{id}' \
  --header 'authorization: text'

200

200

No body

OK