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
To edit and publish a Flow, you need the Editor team permission on every datastore it relates to. Admins are exempt. 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.