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.

Available options:

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

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

200

{
  "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
  }
}

Successful response

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

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://eu1.make.com/api/v2/hooks/{hookId}/incomings' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "ids": [
      "d1efa5318a034d36ad7cbeac543573cf",
      "29d9a7410dff494ab739036f6c332335"
    ],
    "exceptIds": [],
    "all": false
  }'

Delete queue itemsDelete error

200

200

delete

delete-with-error

delete

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

Successful response

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

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://eu1.make.com/api/v2/hooks/{hookId}/incomings/{incomingId}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

Binary queue item

JSON queue item

Binary queue item

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

Successful response

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

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://eu1.make.com/api/v2/hooks/{hookId}/incomings/stats' \
  --header 'Authorization: YOUR_API_KEY'

200

200

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

Successful response