Webhooks

Setup a new webhook endpoint

You can subscribe to different events by creating webhook endpoints in the Settings section

You can find an up-to-date events list at the end of this page.

Configuration

Your endpoint have to respond with a success status. If it responds with a 4XX or 5XX, it will retry multiple times.

On the first fail, it will retry multiple times in the next 2 days. Your server should handle duplicates if you are queueing requests.

It will send you a warning email if it fails after ~10m.

If it fails after all these retries, it will disable your webhook and send you an email.

Payload format

The body:

{
  "event": "request_approved",
  "object_id": 9001,
  "object_type": "request",
  "fired_at": 1617885562,
  "data": data_object
}

With:

• event : the event
• object_id : the id of the object
• object_type : the name of the object
• fired_at : timestamp when the event has been fired
• data_object : a json api payload as specified in the API for each show. For example for a Request model, it’ll use the payload specified for the GET api/v1/requests/:id endpoint.

The headers contains 2 additional values:

• X-Hub-Timestamp, the timestamp when this webhook is sent (which can be different from fired_at in the payload)
• X-Hub-Signature, which is a base64 SHA256 of your verify token concatenate with the timestamp defined in X-Hub-Timestamp

The X-Hub-Signature enables you to verify the sender (in case someone tries to send payloads to your webhhok endpoint).

In order to calculate the X-Hub-Signature, you have to perform the following operation (example in ruby):

Digest::SHA256.base64digest("#{verify_token}#{value_in_x_hub_timestamp}")

Available events

There's currently the following implemented events:

• > A group of documents will expire

  Code: documents_group_will_expire

  This event is triggered when a document group (which has many documents) is going to be expired in exactly one week. This event is usually triggered in the middle of the night by the system.

• > A group of documents has expired

  Code: documents_group_expired

  This event is triggered when a document group (which has many documents) is expired this day. This event is usually triggered in the middle of the night by the system.

• > A group of documents has been rejected

  Code: documents_group_rejected

  This event is triggered when a document group (which has many documents) has been rejected. This event is usually triggered when a single document is refused (it changes the documents group status to rejected).

• > A documents group has to be reviewed

  Code: documents_group_to_review

  This event is triggered when a user uploads a file on a documents group.

• > A form request has to be reviewed

  Code: form_request_to_review

  This event is triggered when a user submit a form.

• > A form request has been approved

  Code: form_request_approved

  This event is triggered when a form has been approved

• > A checklist request is complete

  Code: checklist_request_done

  This event is triggered when all items of a checklist has been checked.

• > A documents request has to be reviewed

  Code: documents_request_to_review

  This event is triggered when a user uploads a file on a documents group and all documents group have at least a document, and at least one documents group need a review. This event is triggered generally when a user uploads all missing, rejected or expired documents on a specific request.

• > A documents request has been approved

  Code: documents_request_approved

  This event is triggered when all documents groups within a request have been approved by someone. It's triggered immediately after a moderator action.

• > A contact has a profile completed

  Code: contact_complete

  This event is triggered when all requests and workflows associated to a contact have been approved by someone. It's triggered immediately after a moderator action.

• > A contact has been invited to a workflow

  Code: contact_invited_to_workflow

  This event is triggered when a contact has been manually invited to a workflow

• > A contact workflow is complete

  Code: contact_workflow_complete

  This event is triggered when a contact workflow has each of this step approved or done.

• > [DEPRECATED] A request has to be reviewed

  Code: request_to_review

  This event is triggered when a user uploads a file on a documents group and all documents group have at least a document, and at least one documents group need a review. This event is triggered generally when a user uploads all missing, rejected or expired documents on a specific request. The new event is 'documents_request_to_review'

• > [DEPRECATED] A request has been approved

  Code: request_approved

  This event is triggered when all documents groups within a request have been approved by someone. It's triggered immediately after a moderator action. The new event is 'documents_request_approved'