Data stores / Data

The following endpoints allow you to create and manage records in data stores.

List data store records

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

/data-stores/{dataStoreId}/data

Retrieves a collection of all records from a data store with a given ID. Each returned record consists of the key (custom or automatically generated) and data.

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

dataStoreIdintegerRequired

The ID of the data store. Get the dataStoreId from the List data stores endpoint.

Example: 137

Query parameters

pg[limit]integerOptional

The maximum number of entities you want to get in the response.

pg[offset]integerOptional

The number of entities you want to skip before getting entities you want.

Responses

200

Successful response

application/json

specobject[]Optional

strictbooleanOptional

countintegerOptional

get

/data-stores/{dataStoreId}/data

HTTPcURLJavaScriptPython

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

200

Successful response

{
  "records": [
    {
      "key": "8f7162828bc0",
      "data": {
        "price": 600
      }
    }
  ],
  "spec": [
    {
      "name": "price",
      "label": "Price",
      "type": "number",
      "default": null,
      "required": true
    }
  ],
  "strict": false,
  "count": 2,
  "pg": {
    "limit": 10,
    "offset": 0
  }
}

Create data store record

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

/data-stores/{dataStoreId}/data

Creates a new record in a data store with a given ID and returns all record details.

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

dataStoreIdintegerRequired

The ID of the data store. Get the dataStoreId from the List data stores endpoint.

Example: 137

Body

application/json

keystringOptional

The unique key of the data store record. If no key is provided, it will be automatically generated.

dataobjectOptional

The data of the data store record. The structure strictly depends on the included data structure. If no data is provided, in response the values will be set to null.

Responses

200

Successful response

application/json

keystringOptional

The unique key of the data store record. If no key is provided, it will be automatically generated.

dataobjectOptional

The data of the data store record. The structure strictly depends on the included data structure. If no data is provided, in response the values will be set to null.

post

/data-stores/{dataStoreId}/data

HTTPcURLJavaScriptPython

POST /api/v2/data-stores/{dataStoreId}/data HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "key": "8f7162828bc0",
  "data": {
    "price": 600
  }
}

200

Successful response

{
  "key": "8f7162828bc0",
  "data": {
    "price": 600
  }
}

Delete data store records

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

/data-stores/{dataStoreId}/data

Deletes records from the specified data store.

Specify the keys of the records you want to delete in the keys array in the request body.

Use the all parameter in the request body to delete all records from the data store. You have to add the confirmed parameter in the API call query to confirm deleting the data, otherwise you get an error.

When you are deleting all records, you can use the exceptKeys parameter to specify keys of the records which you want to keep.

The response contains keys of the deleted records.

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

dataStoreIdintegerRequired

The ID of the data store. Get the dataStoreId from the List data stores endpoint.

Example: 137

Query parameters

confirmedbooleanOptional

Set to true to confirm deleting of the data store records. Otherwise, you get an error and Make won't delete the data store records.

Example: {"value":true}

Body

application/json

keysstring[]Optional

The keys of data store records you want to delete. Use the all and confirmed parameters if you want to delete all records in the data store.

allbooleanOptional

Set to true to delete all records in the data store. Use the confirmed parameter to confirm the deletion. You can also use the exceptKeys parameter to specify keys of the records that you want to keep in the data store.

exceptKeysstring[]Optional

Specify the keys of the data store records you want to keep when deleting all records from the data store.

Responses

200

Successful response

application/json

keysstring[]Optional

delete

/data-stores/{dataStoreId}/data

HTTPcURLJavaScriptPython

DELETE /api/v2/data-stores/{dataStoreId}/data HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "keys": [
    "1abd2defk",
    "568tyuj45"
  ]
}

Delete recordsDelete all records

200

Successful response

{
  "keys": [
    "1abd2defk",
    "568tyuj45"
  ]
}

Update entire data store record

put

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

/data-stores/{dataStoreId}/data/{dataStoreKeyRecord}

Updates a data store record with a given key by passing new data in the request body. It replaces the entire resource with the new values. In the response, this endpoint returns all details of the updated data.

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

dataStoreIdintegerRequired

The ID of the data store. Get the dataStoreId from the List data stores endpoint.

Example: 137

dataStoreKeyRecordstringRequired

The key of the data store record. It can be retrieved from the List data store records endpoint.

Example: ecc4819b2260

Body

application/json

objectOptional

The data is different for each data store so there are no predefined body properties to use. Please see the request example for more details.

Responses

200

Successful response

application/json

keystringOptional

The unique key of the data store record. If no key is provided, it will be automatically generated.

dataobjectOptional

The data of the data store record. The structure strictly depends on the included data structure. If no data is provided, in response the values will be set to null.

put

/data-stores/{dataStoreId}/data/{dataStoreKeyRecord}

HTTPcURLJavaScriptPython

PUT /api/v2/data-stores/{dataStoreId}/data/{dataStoreKeyRecord} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "price": 600
}

200

Successful response

{
  "key": "8f7162828bc0",
  "data": {
    "price": 600
  }
}

Update data store record details

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

/data-stores/{dataStoreId}/data/{dataStoreKeyRecord}

Updates a data store record with a given key by passing new data in the request body. Any property that is not provided will be left unchanged. In the response, it returns all details of the updated data 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

dataStoreIdintegerRequired

The ID of the data store. Get the dataStoreId from the List data stores endpoint.

Example: 137

dataStoreKeyRecordstringRequired

The key of the data store record. It can be retrieved from the List data store records endpoint.

Example: ecc4819b2260

Body

application/json

objectOptional

The data is different for each data store so there are no predefined body properties to use. Please see the request example for more details.

Responses

200

Successful response

application/json

keystringOptional

The unique key of the data store record. If no key is provided, it will be automatically generated.

dataobjectOptional

The data of the data store record. The structure strictly depends on the included data structure. If no data is provided, in response the values will be set to null.

patch

/data-stores/{dataStoreId}/data/{dataStoreKeyRecord}

HTTPcURLJavaScriptPython

PATCH /api/v2/data-stores/{dataStoreId}/data/{dataStoreKeyRecord} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "price": 600
}

200

Successful response

{
  "key": "8f7162828bc0",
  "data": {
    "price": 600
  }
}