- URL: https://[root]/services/[ServiceName].[ServiceType]/webhooks/create(POST only)
- Required Capability:Default administrator role | Feature layer | Geoprocessing
Note:
Users assigned the Geoprocessing privilege will also require the Publish server-based layers privilege to be added to their custom role.
- Version Introduced:11.1
Description
Note:
Webhooks can only be created on your organization's hosting server or a federated server. For additional requirements for either service or organization webhooks, see Create webhooks in the Portal for ArcGIS documentation.
The create operation allows administrators to create a webhook for either an asynchronous geoprocessing service or a feature service. Once the webhook is invoked, it will deliver a payload to the configured payload URL. For geoprocessing services, the webhook is triggered when the geoprocessing job is successfully completed, canceled, or fails to complete. For feature services, administrators can specify the event triggers for the webhook, which range from all possible feature service event triggers to being notified if a single event occurs, such as a feature being created. To configure webhooks for a feature service, the feature service must include the editing capability and have change tracking enabled without sync. These properties can be modified using the updateDefinition operation, which can be accessed in the ArcGIS REST Admin Services Directory by modifying the hosting or federated server's services directory URL as shown below, where <folder> and <serviceName> are changed to reflect the location of the feature service that will be updated:
https://machine.domain.com/webadaptor/rest/admin/services/<folder>/<serviceName>/FeatureServer/updateDefinitionNote:
ArcGIS Enterprise supports organization, feature service, and geoprocessing webhooks. The ArcGIS Portal Directory allows for the creation and management of organization webhooks, whereas the ArcGIS Server Administrative API Directory supports the creation and management of geoprocessing and feature service webhooks. For more information on organization webhooks in ArcGIS Enterprise, see either the ArcGIS Portal Directory API webhook documentation or the Manage webhooks in ArcGIS Enterprise administrative documentation. ArcGIS Online also supports feature service webhooks, which are managed in the ArcGIS Online Administrative Services Directory. To learn more about ArcGIS Online feature service webhooks, see the Web Hooks API documentation.
Request parameters
| Parameter | Details |
|---|---|
| name (Required) | The webhook name. Example |
| changeTypes (Required for feature service webhooks) | Note:This parameter is not applicable to geoprocessing service webhooks. Specifies the event triggers that will invoke the webhook. For more information about the supported event triggers listed below, see the Feature service event triggers section. The values for this parameter can be submitted as a string or as an array. Values: * | FeaturesCreated | FeaturesUpdated | FeaturesDeleted | FeaturesEdited | AttachmentsCreated | AttachmentsUpdated | AttachmentsDeleted | LayerSchemaChanged | LayerDefinitionChanged | FeatureServiceDefinitionChanged Example |
| signatureKey (Optional) | A user-defined string that is sent in the payload to help the webhook receiver authenticate the payload. Example |
| hookUrl (Required) | The payload URL where the payload will be delivered once the webhook is invoked. Example |
| contentType (Optional) | Specifies the media type of the resource. The media type is a string sent with the file indicating the file's format. Values: application/json | application/x-www-form-urlencoded |
| payloadFormat (Optional) | Specifies the response payload format. The default value is json. Values: json | pjson |
| active (Optional) | Specifies whether callbacks will be enabled (true) or disabled (false) when a webhook is triggered. The default value is true. Values: true | false |
| scheduleInfo (Optional for feature service webhooks) | Note:This parameter is not applicable to geoprocessing service webhooks. The window for cataloging event triggers for a feature service. The modifiable values for this parameter are the name property, which allows you to provide a name of the schedule type, and the interval property, which sets the value for how frequently payloads will be delivered. For feature services that receive frequent updates, the schedule for its webhook can be modified to send more frequent payloads containing less information by reducing the interval value. For feature services that receive less frequent updates, the interval value can be raised to send less frequent webhooks that include more event information. The default, and minimum, value for the interval property is 20 seconds. Example, formatted for readability |
| f | The response format. The default format is html. Values: html | json | pjson |
Feature service event triggers
The table below lists the supported event triggers for feature services:
| Event | Details |
|---|---|
| * | Any event is triggered. |
| FeaturesCreated | A feature is created. |
| FeaturesUpdated | A feature is updated. |
| FeaturesDeleted | A feature is deleted. |
| FeaturesEdited | A feature is edited (e.g., insert, update, or delete). |
| AttachmentsCreated | A new attachment is added to a feature. |
| AttachmentsUpdated | A feature attachment is updated. |
| AttachmentsDeleted | A feature attachment is deleted. |
| LayerSchemaChanged | A feature layer's schema is changed. |
| LayerDefinitionChanged | A feature layer's definition is changed. |
| FeatureServiceDefinitionChanged | A feature service's definition is changed. |
Example usage
The following is a sample POST request for the create operation, demonstrating a geoprocessing service webhook:
POST /webadaptor/admin/services/myService.GPServer/webhooks/create HTTPS/1.1
Host: machine.domain.com
Content-type: application/x-www-form-urlencoded
Content-Length: []
name=Microsoft Flow&signatureKey=123456789ABCDE&hookUrl=https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5eb&payloadFormat=pjson&active=true&f=pjsonThe following is a sample POST request for the create operation, demonstrating a feature service webhook:
POST /webadaptor/admin/services/myService.FeatureServer/webhooks/create HTTPS/1.1
Host: machine.domain.com
Content-type: application/x-www-form-urlencoded
Content-Length: []
name=Microsoft Flow&changeTypes=FeaturesCreated&signatureKey=123456789ABCDE&hookUrl=https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5eb&payloadFormat=pjson&active=true&f=pjsonJSON Response syntax
{
"id": "<webhook ID>",
"folderName": "<the service's root folder name>",
"serviceName": "<the service name>",
"serviceType": "<the service type>",
"name": "<user provided webhook name>",
"changeTypes": ["user-defined event triggers"],
"signatureKey": "<user-defined signature key>",
"hookUrl": "<payload URL>",
"active": <true | false>,
"contentType": "<application/json | application/x-www-form-urlencoded",
"scheduleInfo": { //The following object is only returned when creating a feature service webhook, as scheduling info is not applicable to geoprocessing webhooks
"name": "<user provided schedule name>",
"state": "enabled",
"startAt": <time in Epoch>,
"recurrenceInfo": {
"interval": <integer value>,
"frequency": "second"
}
},
"payloadFormat": "<json | pjson>",
"created": <time in Epoch when the webhook was created>,
"modified": <time in Epoch when the webhook was last modified. If just created, this value will be the same as the value above>,
"ownerId": "<username of the webhook's owner>",
"modifiedId": "<username of the user to last modify the webhook. If just created, this value will be the same as the value above>",
"status": "<success message>"
}JSON Response examples
The following is a sample JSON response for a newly created geoprocessing service webhook:
{
"id": "9b9073a2-5569-4873-96d5-b46ebfe07ecb",
"folderName": "System",
"serviceName": "CachingTools",
"serviceType": "GPServer",
"name": "TestGPWebhook",
"changeTypes": ["*"],
"signatureKey": "",
"hookUrl": "https://app.logic.azure.com:443/workflows/...",
"active": true,
"contentType": "application/json",
"scheduleInfo": {},
"payloadFormat": "pjson",
"created": 1670456295297,
"modified": 1670456295297,
"ownerId": "webhooksAdmin",
"modifiedId": "webhooksAdmin",
"status": "success"
}The following is a sample JSON response for a newly created feature service webhook:
{
"id": "e871defd-b339-43eb-aeeb-d500184820c6",
"folderName": "Hosted",
"serviceName": "Test",
"serviceType": "FeatureServer",
"name": "TestWebhook",
"signatureKey": "12345ABCDEF",
"hookUrl": "https://app.logic.azure.com:443/workflows/...",
"active": true,
"contentType": "application/json",
"scheduleInfo": {
"name": "Every20Seconds",
"state": "enabled",
"startAt": 1670521784506,
"recurrenceInfo": {
"interval": 20,
"frequency": "second"
}
},
"payloadFormat": "json",
"created": 1670521908014,
"modified": 1670521908014,
"ownerId": "webhookAdmin",
"modifiedId": "webhookAdmin",
"changeTypes": ["*"],
"status": "success"
}