Devices > Incomings

List

get

Required scope: devices:read

Authorizations

Path parameters

deviceIdstringrequired

Query parameters

scopestringoptionalExample: new_sms

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/devices/{deviceId}/incomings' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "incomings": [
    {
      "id": "27c4879e5fae4d78b0d371f59187fa93",
      "scope": "new_sms",
      "size": 1,
      "created": "2021-01-26T06:55:58.803Z"
    }
  ],
  "pg": {
    "sortBy": "created",
    "limit": 10000,
    "sortDir": "asc",
    "offset": 0
  }
}

Successful response

Delete

delete

"ids" and "all" can no be used together "ids" or "all" has to be set "exceptIds" is possible to use only with "all" It could happen, that some incoming messages are deleted and others not. In this case, the API returns a successful status code, and the response additionally contains an error object with a error description.

Authorizations

Path parameters

deviceIdstringrequired

Query parameters

confirmedbooleanoptionalExample: true

Body

idsstring[]optional

exceptIdsstring[]optional

allbooleanoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://eu1.make.com/api/v2/devices/{deviceId}/incomings' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "ids": [],
    "exceptIds": [],
    "all": true
  }'

200

200

Delete

Delete with error

Delete

{
  "incomings": [
    "4ff11b6d24e24fa9add17d11a8143578",
    "167193ab06d34b879346c69aebc8f5c1",
    "d1efa5318a034d36ad7cbeac543573cf",
    "29d9a7410dff494ab739036f6c332335"
  ]
}

Successful response

Detail

get

Required scope: devices:read

Authorizations

Path parameters

deviceIdstringrequired

incomingIdstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

200

{
  "id": 5,
  "scope": "text",
  "size": 5,
  "created": "2004-10-19T08:23:54.000Z",
  "data": "text"
}

Successful response

Stats

get

Required scope: devices:read

Authorizations

Path parameters

deviceIdstringrequired

Query parameters

scopestringoptionalExample: new_sms

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

200

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

Successful response