Webhook Plugin
Call webhooks based on Vendure events.
npm install @pinelab/vendure-plugin-webhook
Official documentation here
Triggers an outgoing webhook based on configured events. Events are specified in vendure-config
and webhooks are configured per
channel via the admin UI.
YOu can use this plugin for example to trigger builds when ProductEvents or CollectionEvents occur, or send notifications to external platforms when orders are placed by subscribing to OrderPlacedEvents!
Breaking changes since v7.x
:warning: V7 of this plugin allows you to create multiple webhooks per channel for multiple different events. You have to manually recreate your webhooks after migration! (Don't forget your DB migration):
- Check what URL is triggered for what event in your current environment, and note it down somewhere.
- Install the new version, migrate, start the server, and go to
Settings > Webhook
in the Admin UI. - Create the hook. You can leave the
Transformer
field blank: the plugin will send an empty post without a transfomer.
Getting started
- Add the
WebhookPlugin
to your plugins in yourvendure-config.ts
:
- Run a DB migration to create the custom entities.
- Start the server and assign the permission
SetWebhook
to administrators who should be able to configure webhooks. - Go to
settings > webhook
to configure webhooks
Custom transformers
Request transformers are used to create a custom POST body and custom headers for your outgoing webhooks. The example below stringifies the contents of a ProductEvent.