SDK Apps > Webhooks

List App Webhooks

get
/sdk/apps/{SDK_appName}/webhooks
Required scopes
This endpoint requires the following scopes:
Authorizations
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
SDK_appNamestringRequired
Responses
200

Successful response

application/json
get
/sdk/apps/{SDK_appName}/webhooks
GET /api/v2/sdk/apps/{SDK_appName}/webhooks HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "appWebhooks": [
    {
      "name": "postman-test-app-6-1",
      "label": "Test Connection",
      "type": "web",
      "parameters": {},
      "app_version": 1
    },
    {
      "name": "aaaa",
      "label": "Test Connection",
      "type": "web",
      "parameters": {},
      "app_version": 1
    },
    {
      "name": "postman-test-app-6-12",
      "label": "Test Connection",
      "type": "web",
      "parameters": {},
      "app_version": 1
    },
    {
      "name": "postman-test-app-6-13",
      "label": "Test Connection",
      "type": "web",
      "parameters": {},
      "app_version": 1
    }
  ]
}

Create Webhook

post
/sdk/apps/{SDK_appName}/webhooks
Required scopes
This endpoint requires the following scopes:
Authorizations
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
SDK_appNamestringRequired
Header parameters
Content-TypestringOptionalExample: application/json
Body
typestringOptional
labelstringOptional
connectionstringOptional
Responses
200

Successful response

application/json
post
/sdk/apps/{SDK_appName}/webhooks
POST /api/v2/sdk/apps/{SDK_appName}/webhooks HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "type": "web",
  "label": "Watch Events",
  "connection": "my-connection"
}
200

Successful response

{
  "appWebhook": {
    "name": "my-app-1",
    "label": "Watch Events",
    "type": "web"
  }
}

Get Webhook

get
/sdk/apps/webhooks/{SDK_webhookName}
Required scopes
This endpoint requires the following scopes:
Authorizations
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
SDK_webhookNamestringRequired
Responses
200

Successful response

application/json
get
/sdk/apps/webhooks/{SDK_webhookName}
GET /api/v2/sdk/apps/webhooks/{SDK_webhookName} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "appWebhook": {
    "appName": "custom-app",
    "appVersion": 1,
    "name": "custom-app-12",
    "label": "Watch Events",
    "type": "web",
    "connection": "custom-app-1",
    "altConnection": null,
    "api": {},
    "parameters": {},
    "attach": {},
    "detach": {},
    "update": {},
    "scope": {},
    "changes": {},
    "aliasTo": null,
    "endpoint": "https://hook.integromat.com/app/custom-app-12/...",
    "shieldEndpoint": "https://shield.integromat.com/app/custom-app-12/..."
  }
}

Delete Webhook

delete
/sdk/apps/webhooks/{SDK_webhookName}
Required scopes
This endpoint requires the following scopes:
Authorizations
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
SDK_webhookNamestringRequired
Responses
200

Successful response

application/json
delete
/sdk/apps/webhooks/{SDK_webhookName}
DELETE /api/v2/sdk/apps/webhooks/{SDK_webhookName} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "appWebhook": "custom-app-12"
}

Update Webhook

patch
/sdk/apps/webhooks/{SDK_webhookName}
Required scopes
This endpoint requires the following scopes:
Authorizations
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
SDK_webhookNamestringRequired
Header parameters
Content-TypestringOptionalExample: application/json
Body
labelstringOptional
connectionstring | nullableOptional
altConnectionstring | nullableOptional
Responses
200

Successful response

application/json
patch
/sdk/apps/webhooks/{SDK_webhookName}
PATCH /api/v2/sdk/apps/webhooks/{SDK_webhookName} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "label": "Test Renamed",
  "connection": "my-connection",
  "altConnection": null
}
200

Successful response

{
  "appWebhook": {
    "name": "charlie-1",
    "label": "Test Renamed",
    "type": "web",
    "connection": null,
    "altConnection": null
  }
}

Get Webhook Section

get
/sdk/apps/webhooks/{SDK_webhookName}/{SDK_webhookSection}
Required scopes
This endpoint requires the following scopes:
Authorizations
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
SDK_webhookNamestringRequired
SDK_webhookSectionstring · enumRequiredPossible values:
Responses
200

Successful response

application/json
get
/sdk/apps/webhooks/{SDK_webhookName}/{SDK_webhookSection}
GET /api/v2/sdk/apps/webhooks/{SDK_webhookName}/{SDK_webhookSection} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

{
  "output": "{{body}}"
}

Set Webhook Section

put
/sdk/apps/webhooks/{SDK_webhookName}/{SDK_webhookSection}
Required scopes
This endpoint requires the following scopes:
Authorizations
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
SDK_webhookNamestringRequired
SDK_webhookSectionstring · enumRequiredPossible values:
Header parameters
Content-TypestringOptionalExample: application/jsonc
Body
outputstringOptional
testbooleanOptional
Responses
200

Successful response

application/json
put
/sdk/apps/webhooks/{SDK_webhookName}/{SDK_webhookSection}
PUT /api/v2/sdk/apps/webhooks/{SDK_webhookName}/{SDK_webhookSection} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "output": "{{body}}",
  "test": true
}
200

Successful response

{
  "change": {}
}

Last updated