LogoLogo
Get support
  • Home
  • Make API
  • Make Bridge
  • White Label
  • MCP Server
  • Make API documentation
  • Getting started
    • Make API structure
    • HTTP methods
    • Making your first API request
    • Rate limiting
    • Resources
  • Authentication
    • Make roles and API scopes
    • Creating API token
    • Managing API token
    • Requesting an OAuth 2.0 client
    • OAuth 2.0 flow in the Make API
  • Pagination, sorting and filtering
    • Pagination and sorting
    • Filtering
  • Troubleshooting and error handling
    • HTTP status error codes
    • Troubleshooting
  • Client libraries
  • API Reference
    • Affiliate
    • Agents
    • Analytics
    • Audit logs
    • Cashier
    • Connections
    • Custom properties
    • Custom properties > Structure items
    • Data stores
    • Data stores > Data
    • Data structures
    • Devices
    • Devices > Incomings
    • Devices > Outgoing
    • Incomplete executions
    • Enums
    • Custom functions
    • General
    • Hooks
    • Hooks > Incomings
    • Hooks > Logs
    • Keys
    • Notifications
    • Organizations
    • Organizations > User organization roles
    • Remote procedures
    • Scenarios
    • Scenarios > Logs
    • Scenarios > Blueprints
    • Scenarios > Consumptions
    • Scenarios > Custom properties data
    • Scenarios folders
    • SDK Apps
    • SDK Apps > Invites
    • SDK Apps > Modules
    • SDK Apps > RPCs
    • SDK Apps > Functions
    • SDK Apps > Connections
    • SDK Apps > Webhooks
    • SSO certificates
    • Teams
    • Teams > User team roles
    • Templates
    • Templates > Public
    • Users
    • Users > Me
    • Users > API Tokens
    • Users > User team roles
    • Users > User team notifications
    • Users > User organization roles
    • Users > Roles
    • Users > Unread notifications
    • Users > User email preferences Mailhub
Powered by GitBook

Resources

  • Academy
  • Community
  • Help Center

Useful links

  • Support
  • Privacy Notice
  • Status Page
  • make.com

Follow us

  • LinkedIn
  • X (Twitter)
  • Facebook
  • Instagram

© 2025 make.com

On this page
Export as PDF
  1. API Reference

Data structures

PreviousData stores > DataNextDevices

Data structures define the format of the data being transferred to the Make platform. For example, they are widely used by the Data stores component. The following endpoints allow you to create and manage data structures.

Get data structure

get

Retrieves a data structure with a given ID

Authorizations
Path parameters
dataStructureIdintegerRequired

The data structure ID. Get the dataStructureId with the list data structures endpoint.

Example: 1459
Query parameters
Responses
200
Successful response
application/json
get
GET /api/v2/data-structures/{dataStructureId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "dataStructure": {
    "id": 9,
    "name": "Data structure 1",
    "teamId": 1,
    "spec": [
      {
        "type": "text",
        "name": "txt",
        "label": "Text field",
        "default": "default string",
        "required": true
      },
      {
        "type": "number",
        "name": "num",
        "label": "Number field",
        "default": "2,",
        "required": false
      }
    ],
    "strict": true
  }
}

Delete data structure

delete

Deletes a data structure with a given ID and returns the ID in the response.

Authorizations
Path parameters
dataStructureIdintegerRequired

The data structure ID. Get the dataStructureId with the list data structures endpoint.

Example: 1459
Query parameters
confirmedbooleanOptional

Confirms the deletion if a data structure is included in at least one scenario. Confirmation is required because the scenario will stop working without the data structure. If the parameter is missing or it is set to false an error code is returned and the resource is not deleted.

Example: true
Responses
200
Successful response
application/json
delete
DELETE /api/v2/data-structures/{dataStructureId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "dataStructure": 1
}
  • GETList data structures
  • POSTCreate data structure
  • GETGet data structure
  • DELETEDelete data structure
  • PATCHUpdate data structure
  • POSTClone data structure

List data structures

get

Retrieves a collection of all data structures for a team with a given ID. Returned data structures are sorted by name in ascending order.

Authorizations
Query parameters
teamIdintegerRequired

The unique ID of the team whose data structures will be retrieved.

Example: 123
pg[sortBy]string · enumOptional

The value that will be used to sort returned entities by.

Possible values:
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
GET /api/v2/data-structures HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "dataStructures": [
    {
      "id": 9,
      "name": "Data structure 1",
      "teamId": 1
    },
    {
      "id": 1,
      "name": "Data structure 2",
      "teamId": 1
    }
  ],
  "pg": {
    "sortBy": "name",
    "sortDir": "asc",
    "limit": 10000,
    "offset": 0
  }
}

Create data structure

post

Creates a new data structure with data passed in the request body. In the response, it returns all details of the created data structure including its full specification.

Authorizations
Body
teamIdintegerRequired

The unique ID of the team in which the data structure will be created.

namestring · min: 1 · max: 128Required

The name of the data structure. The maximum length of the name is 128 characters.

strictbooleanRequired

Set to true to enforce strict validation of the data put in the data structure. With the strict validation enabled, the data structure won't store data that don't fit into the structure and the storing module will return an error.

The default value of this parameter is false. With the default setting, the modules using the data structure will process data that don't conform to the data structure.

Example: true
Responses
200
Successful response
application/json
post
POST /api/v2/data-structures HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 240

{
  "teamId": 1,
  "name": "Data structure 1",
  "strict": true,
  "spec": [
    {
      "type": "text",
      "name": "txt",
      "label": "Text field",
      "default": "default string",
      "required": true
    },
    {
      "type": "number",
      "name": "num",
      "label": "Number field",
      "default": "1,",
      "required": false
    }
  ]
}
200

Successful response

{
  "dataStructure": {
    "id": 9,
    "name": "Data structure 1",
    "teamId": 1,
    "spec": [
      {
        "type": "text",
        "name": "txt",
        "label": "Text field",
        "default": "default string",
        "required": true
      },
      {
        "type": "number",
        "name": "num",
        "label": "Number field",
        "default": "1,",
        "required": false
      }
    ],
    "strict": true
  }
}

Update data structure

patch

Updates the specified data structure. Make updates only parameters you send in the request body. Note that when you update the data structure specification with the spec parameter, you have to provide all structure fields you want to use. Make replaces the old structure specification with the new one. The response contains all details about the updated data structure.

Authorizations
Path parameters
dataStructureIdintegerRequired

The data structure ID. Get the dataStructureId with the list data structures endpoint.

Example: 1459
Body
namestring · min: 1 · max: 128Optional

The name of the data structure. The maximum length of the name is 128 characters.

strictbooleanOptional

Set to true to enforce strict validation of the data put in the data structure. With the strict validation enabled, the data structure won't store data that don't fit into the structure and the storing module will return an error.

The default value of this parameter is false. With the default setting, the modules using the data structure will process data that don't conform to the data structure.

Example: false
Responses
200
Successful response
application/json
patch
PATCH /api/v2/data-structures/{dataStructureId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 215

{
  "name": "Data structure 1",
  "spec": [
    {
      "type": "text",
      "name": "txt",
      "label": "Text field",
      "default": "default string",
      "required": true
    },
    {
      "type": "number",
      "name": "num",
      "label": "Number field",
      "default": "2,",
      "required": false
    }
  ]
}
200

Successful response

{
  "dataStructure": {
    "id": 9,
    "name": "Data structure 1",
    "teamId": 1,
    "spec": [
      {
        "type": "text",
        "name": "txt",
        "label": "Text field",
        "default": "default string",
        "required": true
      },
      {
        "type": "number",
        "name": "num",
        "label": "Number field",
        "default": "2,",
        "required": false
      }
    ],
    "strict": true
  }
}

Clone data structure

post

Clones the specified data structure. Use the targetTeamId to clone the data structure to the specified team.

The response contains all details of the data structure clone with data structure full specification.

Authorizations
Path parameters
dataStructureIdintegerRequired

The data structure ID. Get the dataStructureId with the list data structures endpoint.

Example: 1459
Body
namestring · min: 1 · max: 128Required

The name of the data structure clone. The maximum length of the name is 128 characters.

targetTeamIdintegerOptional

The ID of the team that should use the data structure clone. If you don't specify the targetTeamId Make clones the data structure in the original team.

Responses
200
Successful response
application/json
post
POST /api/v2/data-structures/{dataStructureId}/clone HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "name": "Cloned data structure",
  "targetTeamId": 22
}
200

Successful response

{
  "dataStructure": {
    "id": 2547,
    "name": "Cloned data structure",
    "teamId": 22,
    "spec": [
      {
        "type": "text",
        "name": "txt",
        "label": "Text field",
        "default": "default string",
        "required": true
      },
      {
        "type": "number",
        "name": "num",
        "label": "Number field",
        "default": "1,",
        "required": false
      }
    ],
    "strict": true
  }
}