Webhook submit action HTTP request

Version:

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!