Introduction to webhook triggers

Valohai triggers can be used to receive webhooks from most online services to launch pipelines on demand.

What are webhooks?

Webhooks are Web requests that many services and applications can send in response to events happening within.

Valohai triggers support a range of industry standard authentication methods for secure and convenient integration with webhook-sending services. While we cannot promise universal compatibility with every application and service out there that can send webhooks, new methods and options can be requested as needed.

Incoming webhook requests can be authenticated and verified using Hash-Based Message Authentication Code (HMAC), JSON Web Tokens (JWT), or with a static shared-secret authentication token. Webhook requests can also be rate limited and checked for a recent timestamp to protect against replay attacks.

The content sent with the webhook (as a POST request body) is available to executions or pipelines as a payload input file. The payload input file is passed through to your execution as-is and can be any data. You are responsible for parsing and processing the file contents according to your requirements. For example, you can register new datasets when they become available. You could also launch another execution or pipeline according to parameters contained in the payload input file.