Webhooks

Send automated notifications to other systems based on actions in Swivle.

Jouke Jongsma avatar
Written by Jouke Jongsma
Updated over a week ago

Dear Swivle user, we are in the process of migrating the Swivle documentation to the main WoodWing Help Center.

The article that you are reading now will therefore not be updated anymore.

For the latest information about this topic, please visit the new version of this article.

Webhooks can be used to notify your application when certain events occur in Swivle.

Example: You may want to alert and respond in your remote application when file metadata is updated or when a Share Link is created.

When a defined event occurs, a HTTP POST with the event payload as a JSON body is sent to the URL that is configured in the Webhook.

Subscribing to events using a Webhook means that your application does not have to periodically poll the Swivle API to determine whether changes have occurred. A webhook delivers data to other applications as it happens, meaning you get data immediately.

Webhooks can be configured through the Management Console. There you will find which events you can receive and detailed samples of the payloads that are delivered.

Webhooks Management Console

API Subscription

Making use of webhooks requires a Swivle API subscription or a subscription plan that includes the API. You can buy your API subscription on the Subscriptions page in the Management Console.

When your API subscription expires, all webhooks will be disabled until you activate a new API subscription.

Consuming a Webhook

You will need to set up a URL in your app that is accessible from the public web that can receive the HTTP POST of the webhook. In some cases you may want to build this yourself, but you can also use integration platforms like Zapier to receive webhooks and trigger automated actions.

Testing webhooks

There are many free tools available to capture and inspect webhook events for testing purposes, such as:

Retry Policy

We will retry anytime we do not receive what we consider a successful response from the destination server. Below is a list of HTTP status codes that we consider as successes/failures.

2xx

Not retried

3xx

Not retried

4xx

Retried

5xx

Retried

Timed Out

When 5 seconds

In total, we will try to invoke the webhook destination 3 times when it keeps failing, so a maximum of 2 retries.

Securing your webhooks

We recommend that you validate that webhook requests are coming from Swivle. Read about how to do this in the article: Securing Webhooks.

Did this answer your question?