Webhook submit action HTTP request

This topic provides an overview of the properties in a webhook submit action request and shows a sample request.

Webhook submit action properties

Every webhook submit action request payload contains the following properties that provide information about the webhook and the action that occurred:

Property	Value type	Description
ActionID	GUID	The processor item ID. Determines which specific webhook sent the data.
ActionName	string	The processor item name. Determines which specific webhook sent the data.
Comments	string	The text from the comment fields.
DataItem	Item	The item that contains the webhook that triggered.
Message	string
NextState	WorkflowState	The state that you want the item to move to. If you insert a submit action webhook in a state, NextState returns null.
PreviousState	WorkflowState	The state that the item moves from.
UserName	string	The user that initiated the workflow action.
WorkflowName	string	The name of the workflow that the item uses.
WebhookItemId	GUID	The ID of the webhook item that subscribed to the event and was triggered.
WebhookItemName	string	The webhook item name.

Sample webhook submit action request in JSON format

The following is an example of a webhook submit action request in JSON format:

{
  "ActionID": "0a6f3cde-edd3-445c-90c3-08d0783e60a3",
  "ActionName": "Sample webhook submit action",
  "Comments": [
    {
      "Key": "Comments",
      "Value": "Approved!"
    }
  ],
  "DataItem": {
    "Language": "en",
    "Version": 1,
    "Id": "2c8e2214-0d54-4a82-8f84-b60c08f169a9",
    "Name": "Sample item",
    "ParentId": "8fb31904-1bbc-463c-821b-c7c1a87bf13e",
    "TemplateId": "0133f52d-271f-4217-b1cd-04342e3457eb",
    "TemplateName": "Sample Item",
    "MasterId": "00000000-0000-0000-0000-000000000000",
    "SharedFields": [
      {
        "Id": "a4f985d9-98b3-4b52-aaaf-4344f6e747c6",
        "Value": "{88AD1387-D4DA-489D-BB4B-45540917E7ED}"
      }
    ],
    "UnversionedFields": [],
    "VersionedFields": [...]
  },
  "Message": "",
  "NextState": null,
  "PreviousState": {
    "DisplayName": "Awaiting approval",
    "FinalState": false,
    "Icon": "Software/16x16/jar.png",
    "StateID": "{87FEC0C1-CAE3-4272-BA58-3DF7082BD1DB}",
    "PreviewPublishingTargets": []
  },
  "UserName": "sitecore\\\\[email protected]",
  "WorkflowName": "Workflow with webhook",
  "WebhookItemId": "0a6f3cde-edd3-445c-90c3-08d0783e60a3",
  "WebhookItemName": "Sample webhook submit action"
}

If you have suggestions for improving this article, let us know!