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:

RequestResponse
{
  "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"
}

Do you have some feedback for us?

If you have suggestions for improving this article,