Audit logs

The following endpoints allow you to get the organization and team audit logs and their details.

You can read more about audit logs in our Help Center.

List organization audit logs

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

/audit-logs/organization/{organizationId}

Gets a list of all audit log entries for the specified organization.

The audit log entries in the response are sorted by the triggeredAt property in descending order by default. You can use pagination to navigate through a large number of entries.

You can get the audit log entries only for organizations in which you have the "Admin" or "Owner" roles. Otherwise, you get the 403 error.

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

organizationIdintegerRequired

The ID of the organization.

Example: 11

Query parameters

teamone ofOptional

The identification of the teams for which you want to get the audit log entries. You can use either team IDs or team names.

The team name can contain any valid UTF8 symbols and spaces.

stringOptionalExample: team 1

or

integerOptionalExample: 1

or

string[]OptionalExample: ["team 1","team 2"]

or

integer[]OptionalExample: [1,2,3]

dateFromstring · dateOptional

Use the dateFrom parameter to get audit log entries from the specified date or newer. Specify the date in the YYYY-MM-DD format.

Example: 2021-09-23T00:00:00.000Z

dateTostring · dateOptional

Use the dateTo parameter to get audit log entries until the specified date or older. Specify the date in the YYYY-MM-DD format.

Example: 2021-09-24T00:00:00.000Z

eventone ofOptional

The list of events for which you want to get audit log entries. To specify multiple events, use the array notation like: GET /audit-logs/organization/{organizationId}?event[0]=key_created&event[1]=connection_created.

You can check the list of supported events with the API call GET /audit-logs/organization/{organizationId}/filters in the events array in the response.

Example: {"value":["key_created","connection_created"]}

stringOptionalExample: webhook_disabled

or

string[]OptionalExample: ["webhook_disabled","webhook_updated","webhook_deleted"]

authorone ofOptional

The identification of the users for whose actions you want to get the audit log entries. You can use either user IDs or user names.

The user name can contain any valid UTF8 symbols and spaces.

stringOptionalExample: author 1

or

integerOptionalExample: 1

or

string[]OptionalExample: ["author 1","author 2"]

or

integer[]OptionalExample: [1,2,3]

pg[offset]integerOptional

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

pg[limit]integerOptional

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

pg[last]integerOptional

The last retrieved key. In response, you get only entries that follow after the key.

Example: 10

pg[sortBy]string · enumOptional

Specify the response property values that Make will use to sort the audit log entries in the response. The default is triggeredAt.

Possible values:

pg[sortDir]string · enumOptional

The sorting order. It accepts the ascending and descending direction specifiers.

Possible values:

pg[returnTotalCount]booleanOptional

Set to true to get also the total number of audit log entries in the response.

Example: true

Responses

200

Audit log entries for the specified organization.

application/json

get

/audit-logs/organization/{organizationId}

HTTPcURLJavaScriptPython

GET /api/v2/audit-logs/organization/{organizationId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Audit log entries for the specified organization.

{
  "auditLogs": {
    "uuid": "c37c7292-35cd-4dc4-9113-21b23beaea7d",
    "createdAt": "2024-05-24T14:22:16.879Z",
    "triggeredAt": "2024-04-19T12:05:22Z",
    "organizationId": 3,
    "organization": {
      "id": 3,
      "name": "John Doe's Organization"
    },
    "eventName": "webhook_created",
    "team": {
      "id": 212,
      "name": "John Doe's Team"
    },
    "actor": {
      "id": 212,
      "name": "John Doe",
      "email": "[email protected]"
    },
    "targetId": "3000",
    "version": {
      "from": "1.0.0",
      "to": "1.0.1"
    }
  },
  "pg": {
    "sortBy": "triggeredAt",
    "sortDir": "desc",
    "offset": 0,
    "limit": 100,
    "totalCount": 60
  }
}

Get organization audit log filters

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

/audit-logs/organization/{organizationId}/filters

Gets available audit logs filters for the organization.

You can use the data in the response to filter audit log entries you get from the GET /audit-logs/organization/{organizationId} endpoint.

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

organizationIdintegerRequired

The ID of the organization.

Example: 11

Responses

200

Successfully retrieve of available audit logs filters for the organization

application/json

get

/audit-logs/organization/{organizationId}/filters

HTTPcURLJavaScriptPython

GET /api/v2/audit-logs/organization/{organizationId}/filters HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successfully retrieve of available audit logs filters for the organization

{
  "teams": [
    {
      "id": 1,
      "name": "John Doe's Team"
    }
  ],
  "users": [
    {
      "id": 1,
      "name": "John Doe",
      "email": "[email protected]"
    }
  ],
  "events": [
    {
      "header": "Webhooks",
      "items": [
        {
          "label": "Webhook created",
          "value": "webhook_created"
        },
        {
          "label": "Webhook updated",
          "value": "webhook_updated"
        }
      ]
    }
  ]
}

List team audit logs

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

/audit-logs/team/{teamId}

Gets a list of all audit log entries for the specified team.

The audit log entries in the response are sorted by the triggeredAt property in descending order by default. You can use pagination to navigate through a large number of entries.

You can get the audit log entries only for teams in which you have the "Team Admin" role. Otherwise, you get the 403 error.

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

teamIdintegerRequired

The ID of the team.

Example: 11

Query parameters

dateFromstring · dateOptional

Use the dateFrom parameter to get audit log entries from the specified date or newer. Specify the date in the YYYY-MM-DD format.

Example: 2021-09-23T00:00:00.000Z

dateTostring · dateOptional

Use the dateTo parameter to get audit log entries until the specified date or older. Specify the date in the YYYY-MM-DD format.

Example: 2021-09-24T00:00:00.000Z

eventone ofOptional

The list of events for which you want to get audit log entries. To specify multiple events, use the array notation like: GET /audit-logs/team/{teamId}?event[0]=key_created&event[1]=connection_created.

You can check the list of supported events with the API call GET /audit-logs/team/{teamId}/filters in the events array in the response.

Example: {"value":["key_created","connection_created"]}

stringOptionalExample: webhook_disabled

or

string[]OptionalExample: ["webhook_disabled","webhook_updated","webhook_deleted"]

authorone ofOptional

The identification of the users for whose actions you want to get the audit log entries. You can use either user IDs or user names.

The user name can contain any valid UTF8 symbols and spaces.

stringOptionalExample: author 1

or

integerOptionalExample: 1

or

string[]OptionalExample: ["author 1","author 2"]

or

integer[]OptionalExample: [1,2,3]

pg[offset]integerOptional

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

pg[limit]integerOptional

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

pg[last]integerOptional

The last retrieved key. In response, you get only entries that follow after the key.

Example: 10

pg[sortBy]string · enumOptional

Specify the response property values that Make will use to sort the audit log entries in the response. The default is triggeredAt.

Possible values:

pg[sortDir]string · enumOptional

The sorting order. It accepts the ascending and descending direction specifiers.

Possible values:

pg[returnTotalCount]booleanOptional

Set to true to get also the total number of audit log entries in the response.

Example: true

Responses

200

Audit log entries for the specified team.

application/json

get

/audit-logs/team/{teamId}

HTTPcURLJavaScriptPython

GET /api/v2/audit-logs/team/{teamId} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Audit log entries for the specified team.

{
  "auditLogs": {
    "uuid": "c37c7292-35cd-4dc4-9113-21b23beaea7d",
    "createdAt": "2024-05-24T14:22:16.879Z",
    "triggeredAt": "2024-04-19T12:05:22Z",
    "organizationId": 3,
    "organization": {
      "id": 3,
      "name": "John Doe's Organization"
    },
    "eventName": "webhook_created",
    "team": {
      "id": 212,
      "name": "John Doe's Team"
    },
    "actor": {
      "id": 212,
      "name": "John Doe",
      "email": "[email protected]"
    },
    "targetId": "3000",
    "version": {
      "from": "1.0.0",
      "to": "1.0.1"
    }
  },
  "pg": {
    "sortBy": "triggeredAt",
    "sortDir": "desc",
    "offset": 0,
    "limit": 100,
    "totalCount": 60
  }
}

Get organization audit log filters

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

/audit-logs/team/{teamId}/filters

Gets available audit logs filters for the team.

You can use the data in the response to filter audit log entries you get from the GET /audit-logs/team/{teamId} endpoint.

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

teamIdintegerRequired

The ID of the team.

Example: 11

Responses

200

Successfully retried available audit logs filters for the team

application/json

get

/audit-logs/team/{teamId}/filters

HTTPcURLJavaScriptPython

GET /api/v2/audit-logs/team/{teamId}/filters HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successfully retried available audit logs filters for the team

{
  "users": [
    {
      "id": 1,
      "name": "John Doe",
      "email": "[email protected]"
    }
  ],
  "events": [
    {
      "header": "Webhooks",
      "items": [
        {
          "label": "Webhook created",
          "value": "webhook_created"
        },
        {
          "label": "Webhook updated",
          "value": "webhook_updated"
        }
      ]
    }
  ]
}

Get audit log detail

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

/audit-logs/{organizationId}/{uuid}

Gets details of the audit log entry with the specified UUID.

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

uuidstringRequired

The UUID of the audit log entry.

Example: c37c7292-35cd-4dc4-9113-21b23beaea7d

Responses

200

Successful response

application/json

get

/audit-logs/{organizationId}/{uuid}

HTTPcURLJavaScriptPython

GET /api/v2/audit-logs/{organizationId}/{uuid} HTTP/1.1
Host: eu1.make.com
Authorization: Token your-api-token
Accept: */*

200

Successful response

{
  "details": {
    "webhookName": "Webhook from John Doe",
    "webhookType": "http"
  },
  "uuid": "c37c7292-35cd-4dc4-9113-21b23beaea7d",
  "createdAt": "2024-05-24T14:22:16.879Z",
  "triggeredAt": "2024-04-19T12:05:22Z",
  "organizationId": 3,
  "organization": {
    "id": 3,
    "name": "John Doe's Organization"
  },
  "eventName": "webhook_created",
  "team": {
    "id": 212,
    "name": "John Doe's Team"
  },
  "actor": {
    "id": 212,
    "name": "John Doe",
    "email": "[email protected]"
  },
  "targetId": "3000",
  "version": {
    "from": "1.0.0",
    "to": "1.0.1"
  }
}