Webhook

Setting up a Webhook.

Overview

A webhook allows you to send data to other services when specific events are triggered in TilliT

For example, when a specific activity passes in TilliT, you can send the data in a payload to Microsoft Dynamics 365.

Creating a Webhook

Go to Settings > Integrations.

Click Actions > Create. You will be presented with a pop-up.

Fill out the following fields:

• Channel Key - a way to name the webhook connection. This will be referenced in the subscriptions later.

• Type - select WEBHOOK from the drop-down menu.

• Endpoint - the URL of the service you need to send data payloads to.

• Options - allows advanced users to add headers to the http request (e.g. an authorization header).

Once completed, click Save and open.

Adding Webhook Subscriptions

Once you've created your connection, you need to subscribe to events in TilliT.

In you newly created channel, go to the Subscriptions tab and click Actions > Create. You will be presented with a pop-up.

The fields you fill in will define how specific or broad the subscription is:

• Event Type - select the event trigger you wish to use (see Event Type).

• Asset - defines a specific Asset to subscribe to.

• Order - defines a specific Order to subscribe to.

• Activity Key - defines a Activity asset to subscribe to.

• Activities Included - does not apply to Webhooks (for email subscriptions only).

If you only select an event type, you will received payloads every time that event triggers. Using the other fields allows you to make more specific subscriptions. In the example shown, we have set the subscription to send a payload on Activity completed, but only for the Activity with the key KWTesting.

Now, whenever that activity successfully completes, the webhook will send it's payload to our other service.

Back to: Integrating TilliT