Skip to main content

Use incoming webhooks to get real-time updates

Listen for events on your Expertli workspaces and keep up-to-date with what's happening in your workspaces!​

Expertli uses webhooks to update your application when an event happens in any of your workspaces. Webhooks are useful for integrating Expertli with other services and applications that require real-time updates. For example, you can use webhooks to receive a notification when a new document is uploaded to a workspace and choose to process it further in your application.

Prerequisites​

  1. Register for Expertli - Sign-up to Expertli or talk to our own Experts and create your Expertli account
  2. Contact our customer staff to enable webhooks for your account

Getting Started​

Under active development

Webhooks are currently only available to customers on the Enterprise plan. If you are interested please contact our customer support staff and ask about enabling webhooks for your account.

Register your webhook endpoint​

  1. Head over to your expertli settings page
  2. Click on the "Integrations" tab
  3. Under the webhooks section, enter your webhook endpoint URL and click "Save"

Webhook events​

Security is important

All Expertli sent webhook events are signed with a secret key and your application must check the signature before processing the event.

Please check the Security page for more information.

Expertli webhooks events all take the following general shape:

{
  "type": "document.uploaded",
  "organisationId": "o1234567890",
  "workspaceId": "w1234567890",
  "data": {
    // Event specific data
  }
}

Acknowledging events​

When you receive a webhook event, you should respond with a 200 OK HTTP status code.

Supported events​

We currently send the following real-time events to your webhook endpoint:

Use the links on the left to discover more about the webhooks!