# n8n Configure an n8n Action

Source: https://userguide.qualytics.io/flows/actions/how-tos/workflow/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](https://www.npmjs.com/package/@qualytics/n8n-nodes-qualytics).

> **Note: 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](https://userguide.qualytics.io/flows/flow/deep-dive/permissions/) for details.

## Field reference

The **n8n Settings** panel shows the following fields.

| Field | Required | Type | Description |
| --- | --- | --- | --- |
| **Webhook URL** | Yes | Text | The n8n webhook URL where Qualytics sends the payload (e.g., `https://your-n8n-instance.com/webhook/qualytics`). |
| **Webhook Secret** | No | 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.

> **Info: 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](https://userguide.qualytics.io/flows/actions/deep-dive/workflow/#payload-structure) for the full example and which fields are included per trigger type.

*Last updated: October 15, 2026.*
