# Send FlyWP Alerts to n8n

> Start an n8n workflow from every FlyWP server and site alert with a webhook and Header Auth, then post the alert to any app n8n supports.

Source: https://flywp.com/docs/account/notification-channels/n8n/

[n8n](https://n8n.io) is a workflow tool. A FlyWP webhook starts an n8n workflow each time an alert arrives, and from there you can post to any app n8n supports.

## Before you start

- A paid FlyWP plan, and the team **Owner** or **Team Admin** role.
- An n8n workflow that can receive web requests. Use the n8n address that is reachable from the internet over HTTPS.

## Step 1: Create the Webhook node in n8n

You can build the workflow yourself, or start from the one FlyWP provides. To use it, click **Download the FlyWP workflow for n8n** in the **Add webhook** form, then import the file in n8n. It has a Webhook node set to **POST** with **Header Auth**, a check for test messages and a check for recoveries, ready for you to connect your own apps.

![Download the FlyWP workflow for n8n link in the Add webhook form](https://flywp.com/wp-content/uploads/2026/11/n8n-download-workflow-link.png)

To build it yourself:

1. In n8n, create a workflow and add a **Webhook** node.
2. Set **HTTP Method** to **POST**.
3. Set a **Path**, for example `flywp-alerts`. If two FlyWP teams send to one n8n, give each team its own path.
4. Set **Authentication** to **Header Auth**.
5. Create a new **Header Auth** credential:
   - **Name**: a header name, such as `X-Auth-Token`.
   - **Value**: a long random value. You can generate one in FlyWP in the next step, and paste it here.

## Step 2: Copy the Production URL and publish

1. In the Webhook node, open the **Production URL** tab and copy the address. Do not use the **Test URL**: it contains `/webhook-test/` and works only while you listen for a test event in n8n.
2. Publish the workflow. A webhook on the Production URL answers only while the workflow is published.

## Step 3: Add the webhook in FlyWP

1. Go to **Team Settings → Notification Channels**.
2. In the **Webhooks** card, click **Add webhook**.
3. Enter a **Name**, such as `n8n alerts`, and paste the Production URL into **URL**.
4. Under **Auth header**, enter the same **Header name** as the n8n credential. Click **Generate** for a **Header value**, copy it with the copy button, and use the same value in the n8n credential. The name and value must match in both places.

   ![Add webhook form with an n8n address, the header name and a generated header value](https://flywp.com/wp-content/uploads/2026/11/n8n-add-webhook-form.png)
5. Click **Send test**. FlyWP should show **Delivered**. In n8n, the **Executions** list shows a run.
6. Click **Next**. Choose the alerts level and the servers, then click **Save**.

## Step 4: Use the alert in your workflow

n8n puts the JSON body in a `body` field. In an expression, read the fields like this:

| You want | Expression in n8n |
| --- | --- |
| The headline | `{{ $json.body.title }}` |
| The severity | `{{ $json.body.severity }}` |
| The site | `{{ $json.body.site.domain }}` |
| A link back to FlyWP | `{{ $json.body.url }}` |
| Whether it is a recovery | `{{ $json.body.recovery }}` |
| Whether it is a test | `{{ $json.body.test }}` |

Add an **If** node on `{{ $json.body.recovery }}` to send "problem" and "recovered" messages differently. Add another on `{{ $json.body.test }}` to ignore the test from **Send test**. The workflow FlyWP provides already does both.

## If it does not work

| What you see | What to check |
| --- | --- |
| **Failed: The receiver answered 404 Not Found.** | This usually means the URL is the Test URL, or the workflow is not published. Use the Production URL and publish. |
| **Failed: The receiver answered 403 Forbidden.** | This usually means the header name or value in FlyWP does not match the n8n credential. |
| **Failed: The certificate of … is not valid.** | The n8n address needs a valid HTTPS certificate. |
| **Failed: No answer in 10 seconds.** | The workflow takes too long to answer. In the Webhook node, answer right away and run the slow steps after it. |
| **Failed: The address must start with https://.** | Use the `https://` address of your n8n. |
| **Failed: This address is not reachable from the internet.** | n8n runs on a private or local address. Use a public HTTPS address. |

Open **Delivery log** on the webhook to see the answer n8n gave for each delivery.

## Related guides

- [Webhooks for Notification Channels](https://flywp.com/docs/account/notification-channels/webhooks/): the full webhook reference, the JSON message and the alert codes.
- [Notification Channels](https://flywp.com/docs/account/notification-channels/): alert levels and which servers and sites a channel gets.
