Agents

List agents

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

/agents

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

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.

Query parameters

organizationIdintegerOptionalExample: 11

Responses

200

Successful response

application/json

get

/agents

HTTPcURLJavaScriptPython

GET /api/v2/agents HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "agents": [
    {
      "id": "text",
      "tenantId": "text",
      "name": "text",
      "clientSecret": "text",
      "status": "ACTIVE",
      "alerted": true,
      "connected": true,
      "version": "text",
      "createdDate": "2025-12-16T17:10:45.623Z",
      "lastConnectionDate": "2025-12-16T17:10:45.623Z",
      "systemConnectionsCount": 1
    }
  ]
}

Get agent details

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

/agents/{agentId}

Retrieves an agents for a agent with given ID

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

agentIdstring · uuidRequired

The ID of the agent.

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

Query parameters

organizationIdintegerOptionalExample: 11

Responses

200

Successful response

application/json

get

/agents/{agentId}

HTTPcURLJavaScriptPython

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

200

Successful response

{
  "agent": {
    "id": "text",
    "tenantId": "text",
    "name": "text",
    "clientSecret": "text",
    "status": "ACTIVE",
    "alerted": true,
    "connected": true,
    "version": "text",
    "createdDate": "2025-12-16T17:10:45.623Z",
    "lastConnectionDate": "2025-12-16T17:10:45.623Z",
    "systemConnectionsCount": 1
  }
}

Create agent

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

/agents/{agentId}

Creates a new agent

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

agentIdstring · uuidRequired

The ID of the agent.

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

Query parameters

organizationIdintegerOptionalExample: 11

Body

application/json

namestringRequired

Responses

200

Successful response

application/json

post

/agents/{agentId}

HTTPcURLJavaScriptPython

POST /api/v2/agents/{agentId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}

200

Successful response

{
  "agent": {
    "id": "text",
    "tenantId": "text",
    "name": "text",
    "clientSecret": "text",
    "status": "ACTIVE",
    "alerted": true,
    "connected": true,
    "version": "text",
    "createdDate": "2025-12-16T17:10:45.623Z",
    "lastConnectionDate": "2025-12-16T17:10:45.623Z",
    "systemConnectionsCount": 1
  }
}

Delete agent

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

/agents/{agentId}

Removes an agent with a given ID.

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

agentIdstring · uuidRequired

The ID of the agent.

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

Query parameters

organizationIdintegerOptionalExample: 11

Responses

200

Successful response

application/json

delete

/agents/{agentId}

HTTPcURLJavaScriptPython

DELETE /api/v2/agents/{agentId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

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

Update agent

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

/agents/{agentId}

Updates a new agent with given ID

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

agentIdstring · uuidRequired

The ID of the agent.

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

Query parameters

organizationIdintegerOptionalExample: 11

Body

application/json

namestringOptional

Responses

200

Successful response

application/json

patch

/agents/{agentId}

HTTPcURLJavaScriptPython

PATCH /api/v2/agents/{agentId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}

200

Successful response

{
  "agent": {
    "id": "text",
    "tenantId": "text",
    "name": "text",
    "clientSecret": "text",
    "status": "ACTIVE",
    "alerted": true,
    "connected": true,
    "version": "text",
    "createdDate": "2025-12-16T17:10:45.623Z",
    "lastConnectionDate": "2025-12-16T17:10:45.623Z",
    "systemConnectionsCount": 1
  }
}