n8n webhook trigger

Pipe Zenovay events into n8n — the open-source workflow tool — and route them to anywhere n8n integrates: Postgres, Redis, GitHub, Notion, your own HTTP API, custom JavaScript.

n8n's Webhook node is what catches Zenovay events. Works the same on self-hosted n8n and n8n Cloud.

---

1. Build the n8n workflow

1. In n8n, create a new workflow.
2. Add the Webhook node as the trigger:
   • HTTP Method: POST
   • Path: pick something descriptive, e.g. zenovay-events
   • Authentication: leave None for now (we'll add HMAC verification in Step 4)
   • Respond: Immediately (the response body doesn't matter to Zenovay; we just need a 2xx)
3. Click Listen for test event at the top of the panel.
4. Copy the Test URL that n8n displays (e.g. https://your-n8n-host.com/webhook-test/zenovay-events). Keep this open — you'll need it in Step 2.

---

2. Add the webhook in Zenovay

1. In app.zenovay.com, go to Settings → Webhooks.
2. Pick the website that should fire events.
3. Click Add webhook.
4. Fill in:
   • Name: n8n — <what the flow does> (e.g. n8n — Save to Postgres)
   • URL: paste the n8n Test URL from Step 1
   • Events: pick what the flow should react to
5. Click Create webhook.
6. Click Send test event (paper-plane icon).

n8n should now show the captured event in the Webhook node. Click Use captured event to use it as the sample payload for the rest of the workflow.

---

3. Switch from Test URL to Production URL

n8n distinguishes Test URLs (only fire when you click "Listen") from Production URLs (always live).

1. Once your workflow is built and tested, click Activate (top right).
2. n8n shows a Production URL — usually identical to Test URL but without -test (e.g. https://your-n8n-host.com/webhook/zenovay-events).
3. In Zenovay's webhook settings, edit the webhook and replace the Test URL with the Production URL.
4. Send another test event to confirm it arrives.

---

4. Verify Zenovay's signature in n8n

For production reliability, verify the HMAC-SHA256 signature so only genuine Zenovay events trigger your flow.

Add a Function node right after the Webhook node:

const crypto = require('crypto');

const signature = $input.item.json.headers['x-zenovay-signature'] || '';
const provided = signature.replace(/^sha256=/, '');
const rawBody = JSON.stringify($input.item.json.body);
const expected = crypto.createHmac('sha256', $env.ZENOVAY_WEBHOOK_SECRET)
  .update(rawBody)
  .digest('hex');

if (provided !== expected) {
  throw new Error('Invalid Zenovay signature');
}

return $input.item;

Set ZENOVAY_WEBHOOK_SECRET as an n8n environment variable (Settings → Variables) using the secret from Settings → Webhooks → click the eye icon on the webhook card in Zenovay.

---

5. Common workflow recipes

---

Troubleshooting

• n8n shows the test event but Production URL doesn't fire: the workflow isn't activated. Click Active toggle (top right) — it must be green.
• HMAC verification fails: confirm you copied the correct webhook secret. The secret is per-webhook, not per-account.
• n8n times out: the Webhook node's default response mode Immediately returns 200 instantly — Zenovay considers that success. If you set When Last Node Finishes, the long flow may exceed Zenovay's 5-second delivery timeout (subsequent retries kick in via the 6-hour cron).

---

Related

• Make.com webhook module recipe
• Zapier catch-hook recipe
• Webhook reference & payload schema