Package Information
Documentation
n8n-nodes-uup
You Up? is an uptime monitoring service that checks your websites, APIs, servers and cron jobs from several locations and alerts you by email, Slack, WhatsApp, SMS and more, only when an outage is confirmed.
This package adds two n8n nodes for You Up?:
- You Up? Heartbeat calls a Heartbeat URL when your workflow succeeds. If a run fails, or the workflow stops running, no call arrives and You Up? alerts you.
- You Up? reads status, Projects, Monitors and Incidents from the You Up? API.
Installation · Heartbeat · Operations · Credentials · Compatibility · Resources
Installation
Follow the installation guide in the n8n community nodes documentation, and install n8n-nodes-uup.
Heartbeat
Use this node to find out when a scheduled workflow stops working.
- In You Up?, create a Heartbeat Monitor. Give it the same schedule as your workflow.
- Copy the Heartbeat URL from the Monitor's Checks card.
- In n8n, add You Up? Heartbeat as the last node of the workflow, and paste the URL.
The node runs only when every node before it succeeded, so a failed run sends nothing. If no call arrives in time, You Up? opens an Incident and alerts you.
Things to know:
- The node calls the URL once per run, however many items reach it. It returns one item:
status(sentorfailed),statusCode,attemptsandsentAt. - Each try waits up to 10 seconds. After a network error or a server error, the node tries up to 3 more times. You can change both under Options.
- By default, a failed call does not stop the workflow, and the node reports the failure in its output. To stop the workflow instead, turn on Options → Fail on Error.
- n8n does not run a node that gets no items. If the node before the Heartbeat can return no items on a good run, turn on Settings → Always Output Data on that node.
- Anyone who has the Heartbeat URL can call it. Keep it private: the node masks it like a password.
The node needs no credentials.
Operations
The You Up? node reads data. It does not change anything in your account.
| Resource | Operation | What it returns |
|---|---|---|
| Status | Get | One item for each Project: its Monitors that are not ok, its open Incidents and its open Regional outages. You can limit it to one Project. |
| Project | Get Many | The Projects your API token can read. |
| Monitor | Get | One Monitor, with its Checks, their status and any open Incident. |
| Monitor | Get Many | A Project's Monitors. Filter by type, state, or words in the name or target. |
| Incident | Get | One Incident, with who acknowledged it and who ended it. |
| Incident | Get Evidence | Where an Incident stopped, in plain words, and what each location saw. |
| Incident | Get Many | A Project's Incidents, newest first. Filter by Monitor, and by open or ended. |
The node can also be used as a tool by n8n's AI Agent.
Credentials
The You Up? node needs a You Up? API token. The You Up? Heartbeat node needs none.
- Sign in to You Up?. In the sidebar, open API tokens and press New token.
- Choose the Project it reaches, or every Project. A Read-only token is enough for this node.
- Copy the token (
uup_api_…). You Up? shows it only once. - In n8n, create a You Up? API credential and paste the token.
Only the owner and admins of an Organization can make tokens. See API tokens.
Compatibility
Needs n8n 2.46.1 or later.
Resources
- You Up?
- You Up? documentation
- Heartbeat Monitors
- You Up? API reference
- n8n community nodes documentation