n8n integration

n8n is a workflow automation tool. Point a Forecite webhook at an n8n Webhook node to run a workflow on every scored feed item — route to Slack, append to a sheet, place an order, anything n8n can reach.

1. Create the Webhook node

In a new n8n workflow, add a Webhook node:

• HTTP Method: POST
• Path: anything (e.g. forecite)
• Copy the node's Production URL — that's the endpoint Forecite will call.

2. Register it in Forecite

On the Webhooks page in your dashboard, add the n8n Production URL as an endpoint and copy the signing secret (whsec_…).

3. Verify the signature

Add a Code node right after the Webhook node to reject unsigned deliveries before doing any work:

const crypto = require("crypto")

const secret = $env.FORECITE_WEBHOOK_SECRET // store your whsec_… here
const raw = JSON.stringify($json.body)
const expected = crypto.createHmac("sha256", secret).update(raw).digest("hex")
const got = $headers["forecite-signature"]

if (expected !== got) {
  throw new Error("Invalid Forecite signature")
}

return $json.body.data // pass the feed item downstream

4. Act on the item

Branch on the verdict with an IF node, then wire up whatever you need:

Webhook → Code (verify) → IF (scoring.actionability == true)
                                 ├─ true  → Slack / Telegram / order
                                 └─ false → no-op

The payload shape matches a feed item, so data.scoring.sentiment_score, data.symbols, and data.title are all available to downstream nodes.