Configure an n8n Action
Add an n8n action to a Flow to trigger n8n workflows directly from Qualytics Flow events. n8n is a workflow automation platform, and Qualytics integrates with it via a dedicated community node (@qualytics/n8n-nodes-qualytics).
Tip
Before configuring this action, install the Qualytics community node in your n8n instance: npm install @qualytics/n8n-nodes-qualytics. You can also find the package on npm.
Permission Required
You need the Manager role to edit and publish Flows. See Flow Permissions for details.
Field reference
The n8n Settings panel shows the following fields.
| Field | Required | Type | Description |
|---|---|---|---|
| Webhook URL | Text | The n8n webhook URL where Qualytics sends the payload (e.g., https://your-n8n-instance.com/webhook/qualytics). |
|
| Webhook Secret | Text | An optional secret sent as the x-qualytics-secret request header, used to authenticate and validate incoming requests in n8n. |
Steps
Step 1: Navigate to the Flows page by clicking Flows on the left side panel.
Step 2: On the Definitions tab, click the Flow. On its canvas, click the dashed Action placeholder after the trigger, or the + handle at the bottom edge of a node.
Step 3: In the List of Actions panel, pick the Workflow category, then click n8n. The n8n Settings panel opens on the right-hand side.
Step 4: Fill in the fields.
Step 5: Click Save. The node shows a CHANGED badge and the You have unpublished changes banner appears on the canvas.
Step 6: Click Publish to make the action live.
What the payload looks like
When the Flow is triggered, Qualytics sends a structured JSON payload via POST to your n8n webhook URL. See Payload Structure for the full example and which fields are included per trigger type.