Click here if you have the New UI option enabled

Overview

When the DataShare API product is enabled the option to use a webhook for notifications is available. Notifications will be sent out whenever there is a change in status for an upload.

Configuration

Users with appropriate permission will be able to set up the configuration in the System Configuration section of Datashare Admin.

You will be able to set the following configuration:

• Webhook On/Off switch
• Webhook URL – Set the URL including the correct protocol of where the notification will be sent to

The format of the notification will be::
 

{

  "event": "String",

  "status": "String",

  "clientId": "uuid",

  "engagementId": "integer",

  "externalEngagementId": "integer",

  "uploadId": "uuid",

  "apiUrl": "url"

}

The fields will have the following details:

event – This will be UPLOAD as currently the only webhook service we are supplying will be on the change of Upload status.

status – This is the upload status and will be one of the following: LOADING, ABORTED, PROCESSING, FAILED, or COMPLETED.

clientId – This is your unique identifier.

engagementId – This is the unique identifier for the engagement.

uploadId – This is the unique identifier for the upload.

apiUrl – This the root url to use when requesting data via API.

New UI 

Overview

When the DataShare API product is enabled the option to use a webhook for notifications is available. Notifications will be sent out whenever there is a change in status for an upload.

Configuration

To access the Webhook settings, select your user account at the top right hand-side and click on Settings. 

On the left hand side, select Integrations, and then Webhook option. 

Users with appropriate permission will be able to set up the configuration in the System Configuration section of Datashare Admin.

You will be able to set the following configuration:

• Webhook On/Off switch
• Webhook URL – Set the URL including the correct protocol of where the notification will be sent to

The format of the notification will be:

{

  "event": "String",

  "status": "String",

  "clientId": "uuid",

  "engagementId": "integer",

  "externalEngagementId": "integer",

  "uploadId": "uuid",

  "apiUrl": "url"

}

The fields will have the following details:

event – This will be UPLOAD as currently the only webhook service we are supplying will be on the change of Upload status.

status – This is the upload status and will be one of the following: LOADING, ABORTED, PROCESSING, FAILED, or COMPLETED.

clientId – This is your unique identifier.

engagementId – This is the unique identifier for the engagement.

uploadId – This is the unique identifier for the upload.

apiUrl – This the root url to use when requesting data via API.

Once the changes have been made, click on 'SAVE' to save the changes.