Hooks > Incomings

When data arrive to a scheduled webhook, Make places the data in the webhook processing queue. Webhooks process data in the same order as they arrive. The following endpoints allow you to inspect and update the webhook processing queue.

Get webhook queue

get

Retrieves a list of webhook queue items waiting for processing with the specified webhook. The request response contains:

  • the incoming payload hash

  • incoming data scope

  • the size of the data in bytes

  • timestamp of the moment when the data were placed in the processing queue

Authorizations
Path parameters
hookIdintegerRequired

The ID of the webhook. Use the GET /hooks API call to get the ID values of your webhooks.

Example: 654
Query parameters
pg[sortBy]stringOptional

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

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/hooks/{hookId}/incomings HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "incomings": [
    {
      "id": "a17c1163d7e04d258fce6bac2c8bd3d6",
      "scope": "hook",
      "size": 1,
      "created": "2021-02-03T09:59:36.260Z"
    },
    {
      "id": "73b56c93f1ff49fe880eeab4fe4c029b",
      "scope": "hook",
      "size": 1,
      "created": "2021-02-03T09:59:38.594Z"
    }
  ],
  "pg": {
    "sortBy": "created",
    "limit": 10000,
    "sortDir": "asc",
    "offset": 0
  }
}

Delete items from webhook queue

delete

Deletes items from the processing queue of the specified webhook. Specify the payload ID values that you want to delete in the request body in the ids array.

You can set the "all": true pair to delete all items from the webhook processing queue. If you use the "all": true parameter, you have to specify the confirmed=true query parameter to confirm the deletion. Otherwise the API call returns the error IM004 (406).

Add the exceptIds array to the request body to specify items you don't want to delete.

The API call response will contain an error message if some of the specified queue items cannot be deleted. The rest of the specified items will be deleted. Deleting a webhook queue item is not allowed when the item is already being processed by the webhook.

Authorizations
Path parameters
hookIdintegerRequired

The ID of the webhook. Use the GET /hooks API call to get the ID values of your webhooks.

Example: 654
Query parameters
confirmedbooleanOptional

Set to true to confirm deleting the webhook queue items. Otherwise the API call fails with the error IM004 (406).

Example: true
Body
idsstring[]Optional

The ID values of the webhook processing queue items that you want to delete. Use the API call GET /hooks/{hookId}/incomings to get the ID values of the webhook processing queue items.

exceptIdsstring[]Optional

If you are deleting all of the incomplete executions with the all:true parameter, you can specify the ID values of the webhook queue items that you want to keep. Use the API call GET /hooks/{hookId}/incomings to get the ID values of the webhook queue items.

allbooleanOptional

Set to true to delete all items in the webhook processing queue.

Responses
200
Successful response
application/json
delete
DELETE /api/v2/hooks/{hookId}/incomings HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "ids": [
    "d1efa5318a034d36ad7cbeac543573cf",
    "29d9a7410dff494ab739036f6c332335"
  ],
  "exceptIds": [],
  "all": false
}
200

Successful response

{
  "incomings": [
    "d1efa5318a034d36ad7cbeac543573cf",
    "29d9a7410dff494ab739036f6c332335"
  ]
}

Get webhook queue item detail

get

Retrieves detail information about the specified webhook queue item. You can get the webhook queue item ID value with the API call GET /hooks/{hookId}/incomings.

Authorizations
Path parameters
hookIdintegerRequired

The ID of the webhook. Use the GET /hooks API call to get the ID values of your webhooks.

Example: 654
incomingIdstringRequired

The ID value of the webhook queue item. Get the list of webhook queue items with the API call GET /hooks/{hookId}/incomings.

Example: 7a567f385d1a4f5ab7bff89162b7605e
Responses
200
Successful response
application/json
get
GET /api/v2/hooks/{hookId}/incomings/{incomingId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "incoming": {
    "id": "7a567f385d1a4f5ab7bff89162b7605e",
    "scope": "hook",
    "size": 31,
    "created": "2020-03-05T14:48:10.537Z",
    "data": {
      "value": "IMTBuffer(22, binary, d4cf3d1cbf035278e7a1a909e71354d7a0387db9): 7b0a20202020226e616d65223a202274657374220a7d"
    }
  }
}

Get webhook queue stats

get

Gets webhook processing queue stats. The response contains the number of items in the webhook queue and the webhook queue limit.

Authorizations
Path parameters
hookIdintegerRequired

The ID of the webhook. Use the GET /hooks API call to get the ID values of your webhooks.

Example: 654
Responses
200
Successful response
application/json
get
GET /api/v2/hooks/{hookId}/incomings/stats HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "incomingStat": {
    "queue": 2,
    "limit": 10000,
    "enabled": true
  }
}