Webhooks

React to events in your packages and automate workflows with webhooks.

Overview

Webhooks allow you to receive near real-time notifications when certain events occur in your packages.

You can use them to automate tasks like triggering custom workflows when a new version of your package is published, or when somebody purchases a license for a package.

Webhooks are available to Privato users on the Growth and Scale plans.

Events

You can create webhooks for the following events:

  • license.created – Fired when a license is created.
  • license.updated – Fired when a license is updated.
  • license.deleted – Fired when a license is deleted.
  • release.published – Fired when a new release is published.
  • package.created – Fired when a new package is created.
  • package.updated – Fired when a package is updated.
  • package.deleted – Fired when a package is deleted.
  • customer.created – Fired when a new customer is created.
  • customer.updated – Fired when a customer is updated.
  • package.downloaded – Fired when a package is downloaded.

Creating a webhook

To create a webhook, navigate to the "Webhooks" section inside of the Privato dashboard and click on the "Create webhook" button.

Each webhook must have a name, destination URL, and at least 1 event associated with it.

The destination URL is the URL that will receive the webhook payload when an event occurs. The request that Privato sends will be a POST request with a JSON body containing details about the event that occurred, e.g. the package created, the license updated, etc.