Checklist Question Change Notifications

The Checklist Question Change Notification is triggered when an existing saved checklist item, additional field, or submission question associated with a manuscript is modified. Custom questions will appear in this notification payload if the option “Include in AOM notification subscription list” is enabled on the custom question configuration page.

Each notification delivers a message payload that includes:

Common elements (shared across all notification types)
Identifiers for the question, detail, and task
Submission and document metadata
External identifiers for cross-platform correlation

Checklist Question Change Payload Elements

Element/Payload Example	Type	Description
questionName `Manuscript Blinded?`	String	The display name of the checklist or submission question that was changed.
questionId `181548`	Integer	Unique internal identifier for the checklist or submission question.
detailId `37940`	Integer	Identifier for the specific instance or detail record of the checklist question. Used to differentiate multiple occurrences of the same question type.
documentTaskId `434798565`	Integer	Globally unique identifier of the workflow task associated with the checklist or submission question.
submissionId `WRK4-23-Apr-0022`	String	Also referred to as Manuscript ID or Document Number. A unique identifier assigned to the manuscript submission.
documentId `50020537`	Integer	Internal numeric identifier of the manuscript in the ScholarOne Manuscripts system.
externalSubmissionId `ERR-1634-08`	String	Unique identifier of the manuscript in an external system, if applicable.
taskId `193137`	Integer	Internal identifier representing the workflow task type that contains the checklist or submission question.

Checklist Question Change Payload

      {
        "questionName": "Manuscript Blinded?",
        "questionId": "181548",
        "detailId": "37940",
        "documentTaskId": "434798565",
        "submissionId": "WRK4-23-Apr-0022",
        "documentId": "50020537",
        "externalSubmissionId": "Unable to Display Letter Tag (##DOCUMENT_ID_EXTERNAL##)",
        "taskId": "193137",
        "notificationServiceVersion": "V3",
        "siteName": "salesdemoplus",
        "subscriptionId": "1559946",
        "subscriptionName": "",
        "subscriptionType": "CHECKLIST_QUESTION_CHANGE",
        "eventDate": "2025-08-15T14:10:12Z",
        "messageUUID": "37c5dd47-69ae-4870-9a70-2914ad1b065b"
      },