Application Webhooks

This webhook is received when an event related to your application is triggered.

warning

Only endpoint configurated with the PRODUCTION appEnv will receive this kind of events.

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 : "APPLICATION"
action	IGNISIGN_WEBHOOK_ACTION_APPLICATION	Yes	The action that is associated to the webhook event
msgNature	IGNISIGN_WEBHOOK_MESSAGE_NATURE	Yes	The type of message
content	IgnisignWebhookDto_Application	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_Application ]

field	type	required	description
userId	string	No	Only provided when the action is MEMBERSHIP_UPDATED.

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_APPLICATION :

  • SETTINGS_UPDATED : A change has been made to the application settings
  • MEMBERSHIP_UPDATED : A change has been made to the application membership
  • ARCHIVED : The application has been archived

• 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)