Node-RED Installation

We provide node-red-contrib-webhookrelay node that can be used with Node-RED to easily received webhooks.

Usage

To use this node, some configuration is required:

  1. Install node-red-contrib-webhookrelay
  2. Create bucket at https://my.webhookrelay.com/buckets
  3. Generate tokens at https://my.webhookrelay.com/tokens
  4. Supply bucket and token key & secret into the node

Detailed steps with screenshots are available below.

Installing node-red-contrib-webhookrelay node

Open ‘palette’ on your Node-RED web interface and install node-red-contrib-webhookrelay node:

install node-red-contrib-webhookrelay node

Creating Webhook Relay bucket

Buckets are like groups where you can have multiple input URLs and multiple outputs. Create at least one output to receive webhooks over WebSocket connection (Node-RED uses it under the hood) then you will be able to resend webhooks manually (good for testing integrations).

Go to your buckets page and create a bucket called nodered and at least one internal output (destination doesn’t matter):

bucket created

Getting token key & secret

Retrieve token key & secret from https://my.webhookrelay.com/tokens page. While token key will remain visible, secret is already encrypted and cannot be decrypted. If you lose your secret, just delete the token and create a new one.

Configuring node-red-contrib-webhookrelay node

Add bucket name and your token key & secret into the node:

configuring webhookrelay node