Skip to navigation

Comments Resource

View as Markdown

The comments resource provides a method that enables you to download a PDF file containing all of the comments that recipients and the sender have added to the documents in an envelope.

Comments are disabled by default. To use the comments feature, an account administrator must enable comments on the account (in the accountSettingsInformation object, set the enableSigningExtensionComments property to true).

For more information, see Comments Settings.

Methods supported

MethodDescription
getGET /restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/comments/transcript
Gets a PDF transcript of all of the comments in an envelope.

Comments properties

PropertyTypeDescription
envelopeIdstringThe envelope ID of the envelope status that failed to post.
hmacstringReserved for Docusign.
idstringA unique ID for the Salesforce object.
mentionsarrayAn array of userIds that are mentioned directly in the body of a comment.
readbooleanIndicates if the comment has been read by the target recipient of the comment.
sentByEmailstring
sentByFullNamestring
sentByImageIdstringReserved for Docusign.
sentByInitialsstring
sentByRecipientIdstring
sentByUserIdstring
signingGroupIdstringThe ID of the signing group.
signingGroupNamestringOptional. The name of the signing group.

Maximum Length: 100 characters.
subjectstring
tabIdstringThe unique identifier for the tab.
textstringSpecifies the text that is shown in the dropdown list.
threadIdstringThe unique identifier for the comment thread.
threadOriginatorIdstringThe userId of the user who created the thread.
timestampstring
timeStampFormattedstring
visibleToarray