Document Request Webhooks

This webhook is received when event related to a document request are triggered.

The Global object received - [type : IgnisignWebhook_ActionDto]

This is the global object that is POST to your application when a webhook event is triggered.

field	type	required	description
topic	String	Yes	Fixed value : "DOCUMENT_REQUEST"
action	IGNISIGN_WEBHOOK_ACTION_DOCUMENT_REQUEST	Yes	The action that is associated to the webhook event
msgNature	IGNISIGN_WEBHOOK_MESSAGE_NATURE	Yes	The type of message
content	IgnisignWebhookDto_DocumentRequest	No	The content of the webhook
error	IgnisignError	No	Rhe eventual error
appId	string	Yes	The appId associated to the event
appEnv	IGNISIGN_APPLICATION_ENV	Yes	The appEnv associated to the event
verificationToken	string	Yes	A token that can be used to verify that the webhook comes from ignisign

SDKs treat automatically these calls and provide to you a callback registration mecanism of typed events.

When you use the SDks:

• The verificationToken is automatically verified.
• The appId and appEnv are automatically checked.
• Only topic, action, msgNature, content and error are available in the callbacks.

The Content object : [type: IgnisignWebhookDto_DocumentRequest ]

field	type	required	description
signatureRequestId	string	Yes	The id of the signature request associated to the document request
signatureRequestExternalId	string	No	An external reference (your reference) if you had provided it when you have created the signature request
documentId	string	Yes	The id of the document associated to the document request
documentExternalId	string	No	An external reference (your reference) if you had provided it when you have created the document
documentNature	string	Yes	The type of document
mimeType	string	Yes	The mime-type of the document provided

The Error object : [type: IgnisignError]

field	type	required	description
errorCode	IGNISIGN_ERROR_CODES	Yes	The Error code
message	string	No	A human readable message describing the error
context	object (any)	No	A map of key value pairs that provide additional context to the error

Related Enumerations :

• IGNISIGN_WEBHOOK_ACTION_DOCUMENT_REQUEST :

  • PROVIDED : Trigerred when a document is provided to a document request

• IGNISIGN_WEBHOOK_MESSAGE_NATURE: Represents the nature or type of a message associated with a webhook event in the IgniSign application.

  • INFO : The message is related provided to provide information (per example a status update)
  • SUCCESS : The message is related to a success (per example a signature session is completed)
  • WARNING : The message is related to a warning (an action is completed but with some warnings)
  • ERROR : The message is related to an error (an action has failed)