Agents

List agents

get

Retrieves a collection of agents for a company with a given ID

Authorizations

Query parameters

organizationIdintegeroptionalExample: 11

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://eu1.make.com/api/v2/agents' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "agents": [
    {
      "id": "text",
      "tenantId": "text",
      "name": "text",
      "clientSecret": "text",
      "status": "ACTIVE",
      "alerted": true,
      "connected": true,
      "version": "text",
      "createdDate": "2025-04-07T02:23:10.261Z",
      "lastConnectionDate": "2025-04-07T02:23:10.261Z",
      "systemConnectionsCount": 1
    }
  ]
}

Successful response

Get agent details

get

Retrieves an agents for a agent with given ID

Authorizations

Path parameters

agentIdstring · uuidrequired

The ID of the agent.

Example: 78781d1f-8cc0-4f42-8e77-c02812f78b53

Query parameters

organizationIdintegeroptionalExample: 11

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://eu1.make.com/api/v2/agents/{agentId}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "agent": {
    "id": "text",
    "tenantId": "text",
    "name": "text",
    "clientSecret": "text",
    "status": "ACTIVE",
    "alerted": true,
    "connected": true,
    "version": "text",
    "createdDate": "2025-04-07T02:23:10.261Z",
    "lastConnectionDate": "2025-04-07T02:23:10.261Z",
    "systemConnectionsCount": 1
  }
}

Successful response

Create agent

post

Creates a new agent

Authorizations

Path parameters

agentIdstring · uuidrequired

The ID of the agent.

Example: 78781d1f-8cc0-4f42-8e77-c02812f78b53

Query parameters

organizationIdintegeroptionalExample: 11

Body

namestringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://eu1.make.com/api/v2/agents/{agentId}' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text"
  }'

200

200

{
  "agent": {
    "id": "text",
    "tenantId": "text",
    "name": "text",
    "clientSecret": "text",
    "status": "ACTIVE",
    "alerted": true,
    "connected": true,
    "version": "text",
    "createdDate": "2025-04-07T02:23:10.261Z",
    "lastConnectionDate": "2025-04-07T02:23:10.261Z",
    "systemConnectionsCount": 1
  }
}

Successful response

Delete agent

delete

Removes an agent with a given ID.

Authorizations

Path parameters

agentIdstring · uuidrequired

The ID of the agent.

Example: 78781d1f-8cc0-4f42-8e77-c02812f78b53

Query parameters

organizationIdintegeroptionalExample: 11

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://eu1.make.com/api/v2/agents/{agentId}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "agent": "78781d1f-8cc0-4f42-8e77-c02812f78b53"
}

Successful response

Update agent

patch

Updates a new agent with given ID

Authorizations

Path parameters

agentIdstring · uuidrequired

The ID of the agent.

Example: 78781d1f-8cc0-4f42-8e77-c02812f78b53

Query parameters

organizationIdintegeroptionalExample: 11

Body

namestringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url 'https://eu1.make.com/api/v2/agents/{agentId}' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text"
  }'

200

200

{
  "agent": {
    "id": "text",
    "tenantId": "text",
    "name": "text",
    "clientSecret": "text",
    "status": "ACTIVE",
    "alerted": true,
    "connected": true,
    "version": "text",
    "createdDate": "2025-04-07T02:23:10.261Z",
    "lastConnectionDate": "2025-04-07T02:23:10.261Z",
    "systemConnectionsCount": 1
  }
}

Successful response